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DECNET FUNCTIONS 


INTRODUCTION 


DECnet is the collective name £or the software products that 
allow the interconnection of various DIGITAL operating systems in 
a structure called a network. DECnet is the implementation of the 
DIGITAL Network Architecture (DNA). 


This module presents an overview of the various capabilities 
of DECnet. 


OBJECTIVES 


At the end of this module the student will be able to under¬ 
stand the possibilities of DECnet. 

RESOURCE 

Digital's Networks: An Architecture With A Future. 
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DECNET FUNCTIONS 


WHAT IS DECNET ? 


DECnet is a family of software products that supports the 
connection of two or more DIGITAL computers to form a network. In 
figure 1-1, DECnet allows computer systems running many different 
operating systems to communicate with each other by means of a 
network. 


Figure 1-1: DECnet Implementations 
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DECNET FUNCTIONS 


DECNET FUNCTIONS 


DECnet networks may actually be considered to be one large 
computing system. This system provides the computer user with 
access to the resources available throughout the network. There 
are several functions and applications available to the user of a 
DECnet network. The following sections describe each of these 
network functions. 


Remote File Access 


DECnet allows terminal users and user-written programs to 
manipulate files on remote network nodes. Remote files may be 
accessed just as if they were located in the local node's file 
system. 

The terminal user may issue DIGITAL Command Language (DCL) 
commands that perform the following remote file functions: 

o Copy files to or from a remote file 

o Delete remote files 

o Submit and execute command files at a remote node 
o Append files to local or remote files 
o List remote directories 

o Queue files to a remote printer 


Terminal-to-Terminal Communication 

DECnet expands the capability of the Phone Utility to allow 
users on two different nodes to send and receive data 
interactively. 


Network Mail 

The Mail Utility allows the transmission of text messages 
between users of a standalone VAX system. DECnet enhances the 
Mail capability by allowing messages to be transferred between 
users on different systems in the same DECnet network. 
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DECNET FUNCTIONS 


Network Virtual Terminal 


The Network Virtual Terminal facility, allows a terminal user 
on a DECnet node to establish a connection to a remote DECnet 
node. Once the connection is established the local terminal acts 
as if it were physically connected to the remote node. 


Remote Resource Sharing 


DECnet allows local node users to share resources available 
on other nodes. Peripheral devices such as disks and printers may 
service several nodes in a network. This capability reduces over¬ 
all hardware costs and increases peripheral utilization. 


Downline Loading 

DECnet provides downline loading services for memory-only 
remote nodes with no local disk storage. Downline loading, in¬ 
volves transferring software from the file system device on a 
DECnet node to a remote system. The software transferred may be 
an operating system image or a task image. 


Downline System Loading 

The initial memory image of the operating system for a remote 
node may be stored on a file system device and loaded on request 
into an adjacent target node. 


Downline Task Loading 

DECnet supports downline loading task images to RSX-11S 
memory-only systems or terminal servers. The initial RSX-11S task 
image is stored on the DECnet file system device and can be 
loaded into an adjacent RSX-11S target node. Tasks already 
executing on the RSX-11S system can be checkpointed to the DECnet 
host file system and later returned to memory in the RSX-11S 
node. 
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DECNET FUNCTIONS 


Upline Memory Pimping 


The upline dumping function supported by DECnet can be used 
to aid in troubleshooting an unattended memory-only system such 
as RSX-11S. When the remote node begins to fail, DECnet's upline 
dumping facility automatically sends a copy of the node's system 
image to an adjacent DECnet-VAX node. This system image can then 
be examined in an attempt to determine the cause of the system 
crash. 


Task-to-Task Communication 


Task-to-Task communication is a function common to most DEC¬ 
net implementations. It allows two programs running under the 
same or different operating systems to communicate with each 
other regardless of the programming languages used. Using DEC¬ 
net-VAX, a VAX/VMS program written in DCL, VAX MACRO, or a native 
mode high-level language can exchange messages with other pro¬ 
grams on the same node or on remote nodes in the same network. 
DECnet imposes no special • data formatting requirements on the 
user. 


Network Management Facilities 


DECnet implements the Network Control Program (NCP) to 
provide three primary network management functions: 

o Display performance statistics and error information 

o Control network components 

o Test network operation 

These functions can be performed at the local node or 
executed at remote nodes that support NCP functions. 

An operator can monitor the status of DECnet activity at any 
node in the network. Statistics are available on the node itself 
as well as on the communication lines. NCP event logging allows 
significant network events to be reported to a terminal device or 
a disk file. 
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DECNET FUNCTIONS 


NCP commands are used to perform network control functions 
such as starting and stopping the network, enabling communication 
lines, changing network characteristics, and downline loading re¬ 
mote systems. 

NCP is also used to test network components by enabling 
transmission and reception of test messages over individual 
lines, either between nodes or through other controller loopback 
arrangements. The messages can then be compared for possible 
errors. 
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SUMMARY 


Within DECnet the user has access to the resources available 
throughout the network. The functions and applications to the 
user are: 
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Remote File Access 
Terminal-to-Terminal Communication 
Network Mail 

Network Virtual Terminal 
Remote Resource Sharing 
Downline Loading 
Downline System Loading 
Downline Task Loading - 
Upline Memory Dumping 
Task-to-Task Communication 
Network Management Facilities 
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DNA 


INTRODUCTION 


DECnet is the implementation of the DIGITAL Network Architec¬ 
ture (DNA). 

DNA is the framework for all Digital communications products. DNA 
consists logically out of several layers. The several network 
functions which have to take place are performed by modules, 
residing in these layers. 

In this module the functions of these layers are discussed. 


OBJECTIVES 


At the end of this module the student will be able to de¬ 
scribe to dataflow through the various DNA-layers and to point 
out which protocols have been used. 


RESOURCE 


Digital's Networks: An Architecture With A Future 
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DNA 


DIGITAL NETWORK ARCHITECTURE (DMA) 


The DIGITAL Network Architecture (DNA) is the group of speci¬ 
fications within which DIGITAL designs its networking products. 
There are many implementations of DECnet, one for each of several 
DIGITAL operating systems. Each implementation varies slightly 
from the others. However, the majority of features and capabili¬ 
ties are common to all DECnet implementations. 

Each DECnet implementation fits into the DNA architectural 
structure. This structure specifies that each group of similar 
network functions must be grouped into an entity called a layer . 
There are eight layers defined by DNA: 

o User Layer 

o Network Management Layer 

o Network Applications Layer 

o Session Control Layer 

o End Communication Layer 

o Routing Layer 

o Data Link Layer 

o Physical Link Layer 

Each layer contains modules responsible for logically related 
functions required in the communication process between network 
nodes. 

The architecture specifies two kinds of relationships between 
modules: 


Interfaces 


Interfaces are the relationships between different modules 
that are usually in the same node. Typically, a module in one 
layer interfaces with a module in the layer immediately below to 
receive a service and with a module in the layer immediately 
above to provide a service. 
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Protocols 


Protocols are the relationships between equivalent modules 
that are usually in different nodes. These protocols consists of 
messages with specific formats and rules for exchanging the 
messages. 


2-1: Basic DNA 
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DNA 


DECNET LAYERS 

DNA defines the following layers, described in order from the 
highest to the lowest. 

User Layer 


The User layer includes all user-written programs and user 
level services that access the network, network services that 
directly support user and application tasks, and overall system 
management. 


Network Management Layer 


The Network Management layer defines the functions used by 
operators and network managers to plan, control, and maintain 
DECnet networks. This layer interfaces with all the layers below 
it to gather data on network performance and to change network 
parameters. 


Network Application Layer 


This layer contains both user-supplied and DlGITAL-supplied 
modules. Its purpose is to define network functions to be used by 
the User layer. DlGITAL-supplied network functions include sup¬ 
port for remote file access to heterogeneous systems in a network 
using the Data Access Protocol (DAP), and the Network Virtual 
Terminal Facility that implements the Command Terminal Protocol 
(CTERM) to allow remote logins to other DECnet nodes. 


Session Control Layer 


The Session Control layer defines the system—dependent 
aspects of process-to-process communication. Its functions 
include name-to-address translation, process addressing, and 
access control. 
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Bnd Communication Layer 


This layer handles the system-independent aspects of commu¬ 
nications, including connection management, data flow control, 
end-to-end error control, and segmentation/reassembly of user 
messages. This layer guarantees delivery of messages from one end 
of the logical link to the other. 


Routing Layer 


The Routing layer software defines the mechanism for routing 
user data from the sending node to the receiving node. It also 
provides network congestion control and packet lifetime control. 


Data Link Layer 


The Data Link layer defines the mechanism for creating an 
error-free communication path between adjacent nodes. This layer 
contains separate modules for each type of network connection and 
supports connections using: 

o DIGITAL Data Communications Message Protocol (DDCMP) 
o Ethernet 
o X. 25 

o Computer Interconnect 


Physical Link Layer 


The Physical Link layer defines the physical aspects of 
transferring data over a transmission line. This includes de¬ 
fining how device drivers and communications hardware should be 
implemented. Functions of this layer include monitoring channel 
signals, clocking on the channel, handling hardware interrupts, 
and informing the Data Link layer when a transmission has been 
completed. 
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DECNET PROTOCOLS 


A protocol is a set of rules that defines the communication 
between equivalent layers residing in different network nodes. 
For example, modules in the Network Application layer on one node 
communicate with modules in the Network Application layer on a 
different node using the Data Access Protocol (DAP). Some DNA 
layers support more than one function and, therefore, include 
multiple protocols. An example is the Data Link layer that sup¬ 
ports the DDCMP, X.25, Ethernet, and Cl protocols. 

Table 2-1 summarizes the DNA software layers (excluding the 
Physical Link layer), protocols used between layers, and the 
functions of each layer. 
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Table 2-1: Phase IV DNA Layers 


Layer 

Major 

Protocols 

Comments 

User 

User-Defined 

Supports user services and programs. 

Network 

Management 

NICE 

//<Z7~\sSC>/Q*r 

//vr 

CGA/fXOc 

&/QC r CA 7 /q/Y 

DAP 

Provides means for configuring, mon- 
toring and controlling the network. 

Network 

Application 

Invokes tasks on behalf of the user 
to perform specific functions (for 
example, transfer data from one node 
to another). 


CTERM 

Allows terminal user on DECnet-VAX 
system to log in to other DECnet-VAX 
systems or other DECnet systems sup¬ 
porting the protocol. 

Session 

Control 

NSP 

C Sc Y>) 

Performs operating system dependent 
functions: • 

- Mapping node name to address 

- Identifying end-user tasks 

- Validating incoming connect re¬ 
quests 

End 

Communication 

NSP 

Performs: 

- Logical link management 

- Guaranteed message delivery 

- Message segmentation 

Routing 

Routing 

Handles: 

- Message packet routing 

- Congestion control 

- Packet lifetime control 

Data Link 

DDCMP 

Provides packet delivery to adjacent 
node on a nonbroadcast circuit. 


Ethernet 

Uses CSMA/CD technique on broadcast 
circuit. 


X.25 (z j 

DLM provides interface to Public 
Packet-Switching Networks (PPSN). 


Cl 

Provides multiple point-to-point 

links over the Star coupler. 
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Figure 2-2: DNA Modules Resident in a Typical DECnet Node 
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DATA FLOW 


In 

node to 

occurs 

letter 

forming 

receivi 

proper 


a DECnet network, information flows from a user on one 
a user or a program on a different node. The process that 
is similar to mailing a letter. The user message is the 
and each DECnet layer adds information to the message 
an "envelope". This added information is used at the 
ng node to process the message and deliver it to the 
user. 


Figure 2-3: Data Developing 
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Figure 2-4: Data Flow Between Nonadjacent DECnet Nodes 
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DECNET PHASES 


Digital has been developing networking products based on DNA 
since 1975. This development effort has occurred in a series of 
phases. So far, there have been four phases. The products in each 
new phase are fully compatible with those produced in the pre¬ 
vious phase. 


Phase III 

Functions that DECnet Phase III systems can perform include: 
o Task-to-task communication 
o Remote file access 
o Terminal-to-terminal communication 
o Network management 

o Downline loading 

o Upline dumping 
o Loopback testing 

The following DECnet products provide Phase III capabilities: 
o DECnet-10 
o DECnet/E 
o DECnet-RT 
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Phase IV 

In addition to being backward-compatible with Phase III, 
Phase IV features include: 

o Ethernet-support 

o Communications server products 

o Large networks 

o Gateway-support to X.25 nodes 

o Gateway-support to SNA-nodes 

The following DECnet products provide Phase IV capabilities: 
o DECnet-VAX 
o DECnet-RSX 
o DECnet-20 
o PRO/DECnet 
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SUMMARY 


The DIGITAL network Architecture is the group of specifica¬ 
tions within which DIGITAL designs its products. DNA describes 
several functions grouped into layers. ZS SO 


The layers defined in DNA are: 
User Layer 

Network Management Layer 


Network Applications layer 


Session Control Layer A/S/C 
End Communication Layer 

/b^oAacoC : 

Routing Layer /?o 

Data Link Layer 


Physical Link Layer 
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So far, there have been four phases of DECnet. At this moment 
the last phase is Phase IV. One of the main new capabilities of 
Phase IV is the support for Ethernet. 
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CONNECTING SYSTEMS 


INTRODUCTION 


There are several ways to connect some computer systems. Both 
hardware and software are needed. The hardware: an interface, and 
some pieces of software: the implementation of the protocols we 
are using. 

This module deals with the different ways to connect two sys¬ 
tems. When these two systems do not use the same protocols a 
gateway is needed. We can also connect a terminal server to a 
host node. Then a different protocol is used, the LAT protocol. 
To specify more effectively the way how the systems are connected 
together we use the terms LINE and CIRCUIT. 


OBJECTIVES 

At the end of this module the student will understand: 
o The different ways to connect two systems 
o The concepts of Ethernet 

o The relation Ethernet - LAT 

o The concepts of CIRCUITS and LINES 

RESOURCES 

Digital's Networks: An Architecture With A Future 
VAX/VMS Networking Manual 


3-1 





CONNECTING SYSTEMS 


NETWORK CONNECTIONS 


DECnet provides the ability to configure nodes in several 
ways to form a network. Depending on the connection configura¬ 
tion, the network may be a local area network (LAN), a wide area 
network (WAN), or a combination of the two. There are several 
ways individual nodes can be connected to other nodes in the net¬ 
work . 

In DECnet are supported: 
o Point-to-point 
o Multipoint 
o Ethernet 
o Cl 
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Point-to-Point 


A point-to-point connection is a direct connection between 
two network nodes where nodes always have access to the communi¬ 
cation line linking them. Nodes can be linked together using 
point-to-point connections to form many types of network configu¬ 
rations. 


Figure 3-1: Network of Point-to-Point Connections 
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Multipoint 


Multipoint connections allow one line to be shared by more 
than two nodes. Each node communicates over the line using a 
separate circuit. One line node, called the control station, 
controls access to the shared communications path; the other line 
nodes are called tributaries. 

Because the line is shared by more than two nodes, an access 
control mechanism must determine which node can use the line at 
any given time. This is known as polling. 


Figure 3-2: Multipoint Connection 
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Ethernet 


Operation 

The Ethernet provides another means of connecting nodes to 
form a network. The Ethernet is a single communications bus that 
allows connection of up to 1,023 nodes. The bus structure of the 
Ethernet allows each node to have equal access to the communica¬ 
tions channel. An access control mechanism is required to ensure 
that only one node transmits at a time. The technique used by the 
Ethernet is called Carrier Sense, Multiple Access with Collision 
Detect (CSMA/CD). In this method, each node can sense when the 
channel is being used. The node waits until the channel is free 
to transmit a message. Should nodes happen to transmit at the 
same time, each node will detect a message collision and wait a 
random time before retransmitting the same message. 


Figure 3-3: Ethernet Configuration 
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Protocol 

The Ethernet-module resides in the Datalink layer of DNA. The 
Ethernet Data Link layer provides a best effort delivery service. 
It does not provide an error-control facility to recover from 
transmission errors. 

This layer has one type of message, the frame. 

The Ethernet-frame format is: 


destination 

source 

type 

data 

f cs 

48 

48 

16 

8n 

32 


, , . 46<-n<-1500 

y&A?***** 

The new standard for Ethernet is IEEE 802.3. The format of the 
datapacket in IEEE 802.3 is slightly different from the Ethernet 
packet format. The IEEE 802.3 format is: 


destination 

source 

length 

data 

f cs 

48 

48 

16 

8n 

32 


46<-n<-1500 


- tt&esr Oyo7//7s*A*- 

as* 2 ,<s A** /7*v te+sjt* 


The length field can have the maximum value 1500. The 
packet is in the first bytes of the datafield. 


type of the 


There are two address fields to identify the source and des¬ 
tination nodes of the frame. Both address fields contain 48 bits. 
In DNA Phase IV, each network node has a 16-bit node address. The 
48-bit Ethernet data link address of a DNA Phase IV node is de¬ 
rived by attaching a 32-bit prefi assigned to DNA Phase IV nodes. 


A node can have a unique Ethernet address 08-00-2b-03-45-26. If 
DECnet is running the node will use an other address, reflecting 
the DECnet node address. The format will be AA-00-04-00-XX-XX. 
The last four hexadecimal digits reflect the DECnet address. If 
the DECnet address is 30.132, the last four digits will be 84-78, 
so the address will be AA-00-04-00-84-78. 


The type field is reserved for use by higher level protocols 
to identify the higher level protocol associated with the frame, 
permitting multiple higher-level protocols to coexist in the same 
Ethernet. 
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Computer Interconnect (Cl) 

The Cl is a high-speed communications path that connects 
nodes in a VAXcluster configuration. VAXclusters consist of 
DECnet-VAX nodes and HSC50 or HSC70 disk controllers. Each 
individual node is connected by a Cl cable to a Star coupler. 


Figure 3-4: VAXcluster Configuration 



ZK-1861-84 
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RELATIONSHIP ETHERNET - LAT 


An Ethernet terminal server can be used to connect several 
users somewhere on the Ethernet to a connected host-node. In this 
situation the Local Area Transport protocol (LAT) is used. 

LAT is an Ethernet-based virtual circuit protocol that does 
not use DECnet as a message transport facility. A terminal server 
on the Ethernet implements the LAT protocol to enable terminals 
that are connected to it to establish a logical link with any 
host node on the same Ethernet. The host node must implement the 
host side of the protocol. 


Figure 3-5: LAT Protocol Implementation 



Ethernet Coaxial Cable 


Advantages of using terminal servers: 

o Less terminal processing on the nodes 
o Increasing flexibility 

o Higher availability of products by switching to another 
node 
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s« 

mode you interact th^cSmpute!? oS^hr^twork 6 ™ 6 *' Service 
important°are listed Stable 3-1? S6Veral comina nds. The most 

Table 3-1: Terminal Server Commands 




Command 

Description 


HELP 

displays information about the basic com¬ 
mands 

HELP MORE 

displays information about the commands 
use the additional facilities 

to 

SHOW SERVICES 

displays the services available to you 


CONNECT XXX 

initiates a session for the service XXX 


[BREAK] 

by pressing the break-key on the terminal 
you return to Local mode 

SHOW SESSION 

displays the sessions of your terminal 


SHOW USERS 

displays information about the connected 
terminals 

RESUME X 

reconnects you to your session nr x 


DISCONNECT SESSION 

x disconnects your session nr x 


LOGOUT 

disconnects all sessions and logs you out 
from the terminal server 

SET FORWARD C 

allows you to set up a special character 
switch to the next session for your port 

to 
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CONNECTING TO OTHER NETWORKS 

. a ni?rr»oh network can communicate with systems ih 

packet-switched data network (PSDN) and with systems in an IBM 
SNA network. 

Connecting to an X.25 Network 


A DECnet node can communicate over a PSDN with other 
and non-DECnet systems if it has been installed with Packetnst 
System Interface (PSI) software that enables the DECnet node to 
be connected logically to a DECnet Router/X.25 Gateway. 


X 25 is a recommendation of the Comite Consultatif Interna¬ 
tional Telephonique (CCITT), which defines a standard means for 
computers to interface with packet-switched data networks. A PSMJ 
is a data communications service offered by common carriers, such 
as the Postal Telephone and Telegraph Authorities (PTT). Each 
PSDN consists of a number of geographically separated switching 
nodes that are connected by high-speed links. When an organiza¬ 
tion leases a circuit from the PTT or other carrier, the circuit 
physically connects a computer in the organization to one of the 
PSDN switching nodes, the data circuit terminating equipment 
(DCE). User Computers or terminals connected to DCEs are called 
data terminal equipment (DTE). 


The way the network delivers the packets is completely 
transparent to the end user who has no influence over the path 
the packet takes through the network. The X.25 recommendation 
specifies the manner in which the data packets get from the user 
to the PSDN. 


When a DECnet node wants to establish communication over a 
PSDN it has to run specific software and sometimes needs to be 
able to access dedicated hardware products. 
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If a DECnet node communicates with DECnet systems only, it 
may be able to use a DECnet facility called data link mapping 
(DLM). DLM allows two DECnet nodes to communicate as though the 
PSDN were not there. The X.25 interface in this situation is com¬ 
pletely transparent to users at both nodes. DECnet node A can use 
DLM if it has access to a DECnet node installed with PSI soft¬ 
ware. The PSI node must be positioned as a DTE in relation to the 
PSDN. If node A does have access to a PSI node, it can send data 
through a DECnet Router/X.25 Gateway node on an Ethernet. To use 
the DLM interface (either through a PSI node or DECnet Router/- 
X.25 Gateway), node A can be located anywhere on the network and 
does not require any special software other than DECnet. 

If users want the option of being able to communicate with 
non-DECnet as well as DECnet systems over the PSDN, their DECnet 
nodes need PSI software. This software allows a DECnet system to 
communicate in X.25 native mode if it is directly connected to a 
PSDN. 
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Figure 3-6: X.25 Gateway Access Operation 
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Connecting to an SNA-network 


DECnet/SNA communications involve sending data from one or 
more DECnet-VAX or DECnet-RSX nodes through a Gateway to an IBM 
system in an SNA network. The protocol differences between the 
IBM network and the Digital network are resolved by interceding 
functions in the Gateway. The IBM SNA network environment sees 
the Gateway as a PU (Physical Unit) Type 2 cluster controller. 

The functions performed at the Gateway are not visible to the 
end user. As far as the user is concerned, the Gateway is a black 
box that receives DECnet data at one end and sends out SNA data 
at the other. The DECnet node(s) and the Gateway involved in 
these communications can be located either in a wide area network 
or on an Ethernet. 

DECnet/SNA Gateway Access functions reside in the Network 
Application layer of a DECnet node. They are designed to make the 
full capabilities of the SNA Data Flow Control, Transmission Con¬ 
trol, and Path Control layers available to user programs residing 
anywhere in a DECnet network. 
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Figure 3-7: 


DECnet/SNA Gateway Access Operation 
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COMMUNICATIONS HARDWARE 

To connect two computersystems you need some pieces of hard¬ 
ware. 

There are a lot of interfaces you can use to make the physi¬ 
cal connection to another system. 

The most important interfaces you can use with DECnet-VAX are 
listed in table 3-2. 

Table 3-2: Interfaces used for DECnet 


Type 

Description 

DMC11 

Synchronous interface, uses an old version of the DDCMP- 
protocol; replaced by the DMRll 

DMRll 

Synchronous interface; uses the DDCMP-protocol 

DMP11 

Synchronous interface; uses the DDCMP-protocol, can be 
used in multipoint and point-to-point mode 

DMV11 

Similar to the DMPll 

DMF32 

Interface with asynchronous DDCMP-lines and one synchro¬ 
nous DDCMP-line 

Cl 

Computer interconnect interface 

DEUNA 

Ethernet-interface for Unibus systems 

DELUA 

New version of the DEUNA 

DEQNA 

Ethernet-interface for Q-bus systems 

DELQA 

New Version of the DEQNA 

OESVA 

Ethernet-interface for the VAX station 

DECNA 

Ethernet-interface for the PRO-350 and PR-380 

DEBNA 

Ethernet-interface for Bi-bus systems 
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LINES AND CIRCUITS 


In DECnet a LINE provides physical conununications and is the 
lowest level communications path; it is part of the physical Link 
Laye r. 

A CIRCUIT is a high-level communications data path between 
nodes. A circuit operates over a physical line using one of the 
protocols DDCMP, Cl, Ethernet and X.25. 

For DDCMP, Cl and Ethernet configurations each circuit is di¬ 
rectly related to a corresponding line. For X.25 configurations 
the circuits and lines do not correspond directly. X.25 circuits 
are multiplexed to lines owned by the X.25 protocol handler mod¬ 
ule . 
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Line Identification 


When the communication interface is used for point-to-point 
or multipoint connections the line identification takes one of 
the following formats: 

dev-c 

dev-c-u 

where: 

dev is a communications interface device name 

c is a decimal number (0 or positive integer) 

designating the device's hardware controller 

u Is a decimal unit or line number (0 or posi¬ 

tive integer) included if the device is a 
multiple unit line controller 

Because the DMR11 is identical in operation to the DMCll, the 
lines have the same mnemonic for identification: DMC. For the 
same reason is the mnemonic DMP used for a DMVll and a DMPll. 

For the ethernet devices the line identification has the for¬ 
mat: 


dev-c 


where dev signs to the controller used. We use the following mne¬ 
monics : 

UNA-C DEUNA or DELUA 

QNA-C DEQNA or DELQA 

CNA-C DECNA 
SVA-C DESVA 
BNA-C DEBNA 
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Circuit Identification 


Each line has an associated circuit defined for software 
purposes. Point-to-point and Ethernet connections define one cir¬ 
cuit per line; a multipoint connection defines as many circuits 
as there are connections. 

The circuit identifications are: 

dev-c.x 

dev-c-u.x 
Where: 

dev is the circuit mnemonic 

c is a decimal number (0 or positive integer) 

designating the line 

u is a decimal line number (0 or positive 

integer) included if the device is a multiple 
unit line controller 

x is a decimal circuit number if the circuit is 

using a multipoint connection 
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Figure 3-8: Multipoint Circuits and Associated Lines 
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When we use the DCL-comraand SHOW NETWORK we see the circuits 
available from our node. See example 3-1. 

$ SHOW NETWORK 

VAX/VMS Network status for local node 2.13 VAXA on 12—AUG—1987 10:44:03.00 


Node 


Links Cost Hops 


2.13 

2.14 
2.16 

2.23 

2.24 


VAXA 

VAXB 

PDPA 

PROB 

VAXC 


Next Hop 

to 

Node 


(Local) 

-> 

2.13 

VAXA 

UNA-0 

-> 

2.14 

VAXB 

DMC-0 

-> 

2.16 

PDPA 

UNA-0 

-> 

2.23 

PROB 

UNA-0 

-> 

2.14 

VAXB 


Total of 7 nodes. 

Example 3-1: The use of the DLC SHOW NETWORK command 
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Table 3-3: LINE and CIRCUIT States 


Status 

Line 

Circuit 

On 

One of the circuits 
using this line must 
be on or on-starting 

The circuit to the 
adjacent node is available 

On-starting 

Not applicable 

The local node has been 
activated, but the remote 
node did not respond yet 

Service 

Used for testing 
purposes 

Used for testing 
purposes 

Off 

None of the circuits 
using this line is in 
status on 

The circuit has not been 
activated 

Cleared 

The protocol software 
has not been loaded 

Not applicable 

Synchronizing 

Not applicable 

The local node has been 
activated and is handling 
the start sequence with 
the remote system. 
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SUMMARY 


To connect a system to a network, we need an interface and a 
protocol to control the datatransport. 

Within DECnet we can choose the Cl-protocol, the DDCMP-proto- 
col, the Ethernet-protocol or the X.25-protocol. 

To use these protocols we need special interfaces 

The circuits in DECnet are displayed with a name derived from 
the name of the used interface. 

The names of the circuits will be displayed when we use the 
DCL-command SHOW NETWORK. 
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USING THE NETWORK CONTROL PROGRAM 


INTRODUCTION 


The Network Control Program is the utility program to use to 
configure, monitor and control the network. You can use NCP to 
display the reachable nodes, the available circuits and lines, 
the number of bytes sent or received. Using NCP in an effective 
way can give you a good insight in the network and its reliabili¬ 
ty. 


OBJECTIVES 


At the end of this module the student will be able to use NCP 
to display the characteristics of the nodes, lines and circuits. 


RESOURCES 


VAX/VMS Networking Manual 
VAX/VMS NCP Reference manual 
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USING THE NETWORK CONTROL PROGRAM 

To display information about the components that make up the 
network we use the Network CONTROL Program (NCP). This informa¬ 
tion can be derived from the volatile database. 

The volatile database, maintained by NETACP, is a memory 
resident database containing current network configuration para¬ 
meters. 

The seven network components you can control using NCP are: 
o Nodes 
o Modules 
o Circuits 
o Lines 
o Objects 
o Logging 
o Links 

To activate NCP use the command: 

$ RUN SYS$SYSTEM:NCP 
NCP> 

With HELP you get online information (see Appendix A) 

To read the volatile database we use the NCP SHOW command. To 
change or set a parameter in the volatile database we use the NCP 
SET command. 

To clear network parameters or reset them to the default val¬ 
ues we use the NCP CLEAR command. 

To use these NCP commands we sometimes need some privileges. 

For the NCP SHOW command no special privilege is required; 
for the NCP SET and CLEAR commands the OPER privilege is needed. 



USING THE NETWORK CONTROL PROGRAM 


To display the characteristics of the node components we use 
the command: 

NCP SHOW <component> <parameter> <qualifier> 


where: 


<component> 

EXECUTOR 

ACTIVE NODES 

KNOWN NODES 

ADJACENT NODES 

NODE XXX 

ACTIVE CIRCUITS 

KNOWN CIRCUITS 

ACTIVE LINES 

KNOWN LINES 

KNOWN LINKS 

LINE line-id 

CIRCUIT circuit-id 

LINK link-id 

<parameter> 

CHARACTERISTICS 

COUNTERS 

STATUS 

<qualifier> 

SUMMARY 

ADJACENT NODE node-id 

TO file-spec 


With VMS V5 it is possible to use wildcards in NCP-commands. 
For instance: SHOW NODE 

or: SHOW circuit DMB * CHARACTERISTICS.REM* 
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NCP> SHOW KNOWN LINES 


Known Line Volatile Summary as of 12-AUG-1987 12:58:08 
Line State 


DMC-0 on 
DMF-0 on 
DMF-1 on 
UNA-0 on 


NCP> SHOW CIRCUIT DMC-0 CHARACTERISTICS 

Circuit Volatile Characteristics as of 12-AUG-1987 11:43:22 


Circuit - DMC-0 

State 

Substate 

Service 

Cost 

Hello timer 
Verification 


on 

-starting 

enabled 

5 

15 

disabled 


NCP> SHOW ADJACENT NODES TO NODES.FILE 
NCP> SHOW EXECUTOR SUMMARY 

Node Volatile Summary as of 13-AUG-1987 11:57:51 
Executor node - 2.13 (VAXA) 

State - on 

Identification - DECnet-VAX V4.5, VMS V4.5 


NCP> SHOW ACTIVE NODES 

Active Node Volatile Summary as of 13-AUG-1987 12:45:27 
Executor node - 2.13 (VAXA) 

State - on 

Identification - DECnet-VAX V4.5, VMS V4.5 


Node 


State Active Delay 

Circuit 

Next node 


Links 






2.14 

(VAXB) 

reachable 

UNA-0 

2.14 

(VAXB) 

2.16 

(PDPA) 

reachable 

UNA-0 

2.16 

(PDPA) 

2.23 

(PROB) 

reachable 

UNA-0 

2.23 

(PROB) 

2.24 

(VAXC) 

reachable 

UNA-0 

2.14 

(VAXB) 


Example 4-1s Use of NCP 
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REMOTE USE OF NCP 

You can use the NCP TELL-command to have the NCP-conunand exe¬ 
cuted at another node. The TELL-command sets the executor for 
only one command and must prefix the command for which it is 
intended. 

NCP> TELL VAXA SHOW KNOWN NODES 

NCP> TELL 2.45 SHOW EXECUTOR CHARACTERISTICS 

Another way to have your NCP-commands executed at another 
node is setting the executor for your own process. 

NCP> SET EXECUTOR NODE PDPA 

NCP> SHOW KNOWN NODES 

NCP> SHOW CIRCUIT UNA-0 CHARACTERISTICS 

NCP> CLEAR EXECUTOR NODE- 
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SUMMARY 


The network Control Program is the utility program to use to 
configure, monitor and control the network. You can use NCP to 
display the reachable nodes, the available circuits and lines, 
the number of bytes send or received by using the NCP command NCP 
SHOW <component>. 
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ROUTING 


INTRODUCTION 


When a packet is sent from one system to another there has to 
be a path through the network. The systems the packet visits has 
to determine in which way this packet has to travel to its desti¬ 
nation. This process is the routing process. 

This module introduces the routing process, the operations 
performed and the terms used to describe the routing process. 


OBJECTIVES 


At the end of this module the student will be able to: 

o Define and illustrate the terms associated with the DNA 
routing concept 

o Describe the functional operations performed by the DNA's 
Routing Layer 


RESOURCES 


VAX/VMS Networking Manual 

DECnet DIGITAL Network Architecture (Phase IV) General De¬ 
scription 
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ROUTING 


DECnet implements a feature called adaptive routing which 
eliminates the need for every node to be physically connected to 
every other node in the network. Adaptive routing enables a mes¬ 
sage to get from the source node to the destination node even if 
it must pass through several intervening nodes. 

Adaptive routing uses an algorithm that enables network nodes 
to send messages over the path that is the least costly in terms 
of system resources. In the event the chosen path fails, adaptive 
routing finds an alternative path to complete the communication. 


DECNET NODE TYPES 

DECnet supports two types of network nodes: 
o Full function nodes or routing nodes 
o End nodes or non-routing nodes 

-2T 

£ £\S6C J2T 
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mil Function Nodes 


Full function nodes (also called routing nodes) are nodes 
that can receive and forward messages addressed to other nodes in 
the network. This ability ’requires that the node possess and 
maintain a database listing of all the available paths to other 
network nodes. This database contains the cost of each alterna¬ 
tive path to a destination node. It is updated by processing 
routing messages sent throughout the network when a node's 
routing information changes. The DECnet routing layer uses this 
information to perform the adaptive routing function. 


End Nodes 


A DECnet end node does not have route-through capability. It 
can only send messages to one adjacent node that then forwards 
the message toward its ultimate destination. DECnet operation on 
an end node requires less resources than on a full function node. 
The end node: 

o Does not maintain a database on the state of the network 

o Does not listen to routing messages 

X/ 

o Uses less CPU time than a full function node Q 

o Allows increased data link usage because there is no 

routing overhead or route-through traffic 
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Figure 5-1 shows an example of a network containing both full 
function nodes and end nodes. 

Figure 5-1: Sample DECnet Network 



MKV860308 


Using the network topology shown in figure 5-1 we can 
construct the routing databases for the different nodes. 


5-4 
































ROUTING 


Figure 5-2: Local Node Route Database Table 


Route database built in a DECnet node during route initialization 


NETWORK CONFIGURATIONS 
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ROUTING CONCEPTS AND TERMS 


In table 5-1 
listed. 

the most important terms used with routing are 

Table 5-1: Routing 

Terms 

Term 

Description 

Hop 

The logical distance between two nodes is 
measured in hops. The distance between two ad¬ 
jacent nodes is one hop. 

Path 

The route a packet takes from source to desti¬ 
nation. 

Path length 

The number of hops along a path between two 
nodes; it is the number of circuits a packet 
must travel across to reach its destination. 

Cost 

An integer value assigned to a circuit between 
two adjacent nodes, usually proportioned to 
transmission delay. 

Path cost 

The sum of the circuit costs along a path be¬ 
tween two nodes. 

Reachable node 

A destination node to which the routing layer 
on the local node has a usable path. 

Maximum visits 

The maximum number of nodes through which a 
packet can be routed before arriving at the 
destination node. 

Maximum cost 

A remote node is unreachable when the cost of 
a circuit to that host is higher than this 
maximum. 

Maximum hops 

A remote node is unreachable when the number 
of hops to that host is higher than this maxi¬ 
mum. 

Maximum address 

A remote node is unreachable when the address 
of the remote node is higher than this maxi¬ 
mum . 
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Table 5-1: Routing Terms (continued) 


Term 


Description 


Hello timer 


Listen timer 


Routing timer 


Pipeline quota 


Defines the frequency of router layer Hello 
messages 

Controls the maximum amount of time allowed to 
elapse before the routing layer stops waiting 
for a message from the adjacent node on the 
circuit. 

Defines the frequency of routing messages to 
all adjacent nodes. 

The maximum number of messages or packets that 
a transmitting node can send without waiting 
for individual acknowledgments for each suc¬ 
cessive message. 


Broadcast routing timer 

Defines the frequency of routing updates on an 
Ethernet. 

Nax broadcast nonrouters 

If the local node is a routing Ethernet node, 
this parameter defines the maximum number of 
endnodes for which the local routing node will 
store routing information. The endnodes are in 
the same area on the Ethernet. 

Max broadcast routers 

If the local node is a routing Ethernet node, 
this parameter defines the maximum number of 
routing nodes for which the local routing node 
will store routing information. The routing 
nodes are in the same area on the Ethernet 


Designated router 

A routing node on an Ethernet which provides a 
router service for the end nodes on the 
Ethernet. 
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Maximum path splits 

Indicates the mamimum number of equal cost 
paths for a given destination node among which 
the packet load may be split. 

Path split policy 


Specifies the policy for equal cost load 
splitting of network traffic. If the policy 
has the value INTERIM, then all traffic will 
be split over all equal cost paths. If the 
policy has the value NORMAL, then all traffic 
will be split equally over all equal cost 
paths to a destination node. 


The most part of these parameters is displayed by the NCP 
command NCP SHOW EXECUTOR CHARACTERISTICS (See example 5-1). 

The circuit-related parameters are displayed by the NCP command 
NCP SHOW CIRCUIT xxx-n CHARACTERISTICS; the line-related by the 
equivalent command for lines. 
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NCP> SHOW EXECUTOR CHARACTERISTICS 

Node Volatile Characteristics as of 5-NOV-1988 11:50:13 
Executor node - 2.14 (VAXB) 


Identification 
Management version 
Incoming timer 
Outgoing timer 
Incoming Proxy 
Outgoing Proxy 
NSP version 
Maximum links 
Delay factor 
Delay weight 
Inactivity timer 
Retransmit factor 
Routing version 
Type 

Routing timer 
Broadcast routing timer 
Maximum address 
Maximum circuits 
Maximum cost 
Maximum hops 
Maximum visits 
Maximum area 

Max broadcast nonrouters 
Max broadcast routers 
Maximum path splits 
Area maximum cost 
Area maximum hops 
Maximum buffers 
Buffer size 
Nonprivileged user id 
Default access 
Pipeline quota 
Alias incoming 
Alias maximum links 
Alias node 
Path split policy 


DECnet-VAX V5.0, VMS V5.0-2 
V4.0.0 
45 
60 

Enabled 

Enabled 

V4.0.0 

32 

80 

5 

60 

10 

V2.0.0 
routing IV 
600 
180 
1023 
16 

1022 

30 

63 

63 

64 
32 
1 

1022 

30 

100 

576 

DECNET 

incoming and outgoing 

3000 

Enabled 

32 

2.24 (CLUSTER) 

Normal 


Example 5-1: Using NCP to display the executor characteristics. 
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AREA ROUTERS 


DECnet Phase III supports a maximum of 255 nodes. Phase IV 
DECnet nodes support new features as area routing, which permits 
the configuration of large networks and Ethernet support. Phase 
IV DECnet can support up to 63 areas with up to 1023 nodes in 
each area. 

In DECnet Phase IV there are two kinds of routers: 
o Level 1 routers 

o Level 2 routers 

Level 1 routers route traffic within a single area of the 
network. Their routing database contains routing information for 
only the nodes within their area. 

Level 2 routers are known as area routers. They are used to 
routing messages between the nodes in one area and the nodes in 
other areas. They maintain two routing databases, one containing 
the nodes in their own area and the other containing information 
about all the other level 2 routers on the network. 
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SUMMARY 


In a DECnet network a packet chooses a path from th source to 
the destination. The systems the packet visits has to decide 
which path it has to ho. These systems are the so-called Routers 
These routers have a database with information on how to get to 
the different systems in the network in the most efficient way. A 
system forces a packet to take a certain circuit by looking at 
the cost of the circuit and to total the number of hops it takes 
to get to the destination. 

The executor node can decide to forward the packet or not, by 
looking at certain parameters the network manager has set in his 
database. These parameters will be displayed by using the command 
NCP SHOW EXECUTOR CHARACTERISTICS. 
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USING SET HOST, PHONE AND MAIL 


INTRODUCTION 


To use the resources on another system without disconnecting 
our terminal from our own system we can set up an interactive 
session on the remote system by using the SET HOST command. To 
communicate with other users on the systems in the network we use 
the MAIL and PHONE commands. 

In this module the following commands are discussed: 

o SET HOST 

o MAIL 

O PHONE 


OBJECTIVES 


At the end of this module the student will be able to use the 
SET HOST command and the MAIL and PHONE commands, and understand 
what is happening when he uses these commands. 


RESOURCES 


VAX/VMS Mail Utility Reference Manual 
VAX/VMS Phone Utility Reference Manual 
VAX/VMS Networking Manual 
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LOGICAL LINKS 


A logical link connects an image or program running on the 
local node with an image running on a remote node. The logical 
link is a temporary data path that exists until one of the two 
images terminates the connection. 
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UTILITIES INTERFACES 


The utilities available to the VAX/VMS user may also be used 
across the network. The user may access these utilities through 
standard DCL commands. When the DCL command includes a node name 
m the file specification, network access is initiated. When the 
DCL command initiates network access, a logical link is 
established. 

The following list of DCL commands initiates utilities that 
allow the user to access remote network nodes: 


o Remote command terminal 
- SET HOST 


o Terminal-to-terminal communication 

- PHONE 

o Network mail 

- MAIL 

o Remote resource sharing (Module 8) 

- PRINT/REMOTE 

- BACKUP 

- SUBMIT/REMOTE 


o File manipulation (Module 8) 


- APPEND 

- COPY 

- DELETE 

- OPEN 

- TYPE 


CLOSE 

CREATE 

DIRECTORY 

READ 

WRITE 


o Device handling (Module 8) 


- ASSIGN - DEASSIGN 

- DEFINE 


6-3 





USING SET HOST, PHONE AND MAIL 


REMOTE COMMAND TERMINAL 


To Start a Remote Terminal Session 

To start a remote terminal session, a user invokes the SET 
HOST command and specifies a remote node. After a connection has 
been made, the user can access the resources of the remote 
system. 

o SET HOST <nodename> 

o Log on to the remote system 

You can use SET HOST more than one time. 

Using SET HOST a logical link has been created between the 
local process and REMACP on the remote system. The protocol used 
is CTERM. Now the user has an RT_device on the remote node. 

Using SET HOST to an RSX-system creates a logical link 
between the local process and RTH. 


Terminating a Remote Session 

To terminate a remote session on a VAX system, do one of the 
following: 

o Log out 

o Press CTRL/Y two or more times 
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Example 6 


S SET HOST VAXA 


WELCOME TO VAXA 
PLEASE LOG IN 


Username: STUDENT 
Password: (not echoed) 

$ 


1: Using the SET HOST command 
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PHONE 


You can use the PHONE-command for terminal-terminal 
communication. If the person you want to phone is not available 
on the system you can leave a message by using the MAIL command 
in PHONE. 

Phone can also be used to display the users on a system 
somewhere on the net. For this purpose we use the DIR command in 
phone. 

The qualifiers and commands we can use during the PHONE 
session are listed in table 6-1 and table 6-2. 


VAX/VMS Phone Facility 


%DIR VAXA 


Press any key to cancel the directory listing and continue. 


Process Name 


User Name 


Terminal 


Phone Status 


HACKER 

PETER 

Marty James 


JOHNSON 

PETER 

JAMES 


VTA24: 

VTA218: 

VTA290: 


available 

available 

available 


3 persons listed. 


Example 6-2: Using the PHONE DIR command 
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Table 6-1: PHONE Qualifiers 


Qualifier 

Function 

/scroll 

When the viewport is full, the text is 
scrolled up one line and new text goes to 
the bottom line. Scroll is the default. 

/noscroll 

New text is wrapped and appears on the top 
line of the viewport. This will improve 
response on slow speed terminals. 

/switchhook="C" 

This is the character which must be typed 
before each phone command. The default is %. 

/viewportsize=n 

This is the maximum number of lines in the 
viewport, including heading line and bottom 
line of dashes. The valid range is from 3 to 
10. 


6-7 






USING SET HOST, PHONE AND MAIL 


Table 6-2: PHONE Commands 


Command 

Meaning 

ANSWER 

Answers the phone when the user receives a 
call* 

DIAL 

Places a call to another user. 

EXIT 

Exits from PHONE. 

FACSIMILE 

Includes the contents of a file in the 
user's conversation. 

HANGUP 

Hangs up the user's own phone. 

HELP 

Displays information on how to use PHONE. 

HOLD 

Places other users on hold. 

MAIL 

Sends a short message to another user. 

REJECT 

Rejects a call from another user. 

UNHOLD 

Reverses the previous hold command. 
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MAIL 

To send network mail to another person somewhere on the net 
you can use the MAIL facility. You can use the MAIL facility to 
send a message or a file to a single person, or a group of 
persons by using a distribution list. 

Table 6-3: Summary of MAIL Commands 


Command 

Meaning 

BACK 

Backs up to the previous message. 

COMPRESS 

Creates a new MAIL.MAI file, without the 
deleted mails, and renames the old 
MAIL.MAI file to MAIL.OLD. 

DELETE n-m 

Deletes the messages. 

DIRECTORY 

Lists a summary of user messages. 

EXIT 

Exits form MAIL. 

EXTRACT 

Copies current message into a specified 
file. 

FILE 

Copies current (last-read) message into a 
specified folder. 

FORWARD 

Forwards current (last-read) message to 
user or users. 

HELP 

Displays information on how to use MAIL. 

PRINT/QUE-XXX 

Submits the current (last-read) message 
to queue>XXX 

READ and <RETURN> 

Displays next page, next message, or 
(READ only) specified message. 

READ/EDIT n 

Displays specified message, using the 
editor. 
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REPLY 

SEARCH string 
SET FORWARD 

SHOW ALL 


Sends a reply to the sender of the 
current (last-read) message. 

Searches MAIL file for the first match of 
string. 

The result of this command is, that mail 
will be sent to the specified 
destination. 

Displays the characteristics of your mail 
session. 
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$ MAIL 

You have 2 new messages. 

MAIL> SEND 

To: VAXA::PETERS 

Subj: NEXT MEETING 

Enter your message below. Press CTRL/Z when complete, 
or CTRL/C to quit: 

Next fryday will be a meeting in room 4.23 
Time: 14:00 hour 
*Z 

MAIL> 

MAIL> SEND/EDIT 
To: H711DOC 

Subj: Planning 24 OCT 1988 


MAIL>DIR 

NEWMAIL 

# From Date Subject 

1 VAXA::PETERS 14-oct-1988 Plan new products 

2 VAXWRK::JOHNSON 18—oct—1988 Meeting next fryday 


MAIL>READ 1 

#1 18-oct-1988 11:51:50.57 NEWMAIL 

From: VAXA::PETERS 

To: WILLIAM 

Subj: Plan new products 

Hallo Bill, 


The products listed in Catalogue will be available at the end of 
this week. 


Bye, John. 
MAIL> PRINT 
MAIL> READ 2 


MAIL> DELETE 
MAIL> EXIT 

Job MAIL (que SYS$PRINT, entry 243) started 


Example 6-3: Sending and Reading your Mail 
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$ NAIL 


You have 2 new messages. 


MAIL>READ 1 

|1 ie-oct-1988 11:51:50.57 

From: VAXA::PETERS 

To: WILLIAMS 

Subj: Plan new products 

Hallo Bill, 


NEWMAIL 


The products listed in Catalogue will be available at the end of 
this week. 


Bye, John. 


MAIL> SET COPY_SELF REPLY,SEND 
MAIL> REPLY/EDIT 

To: VAXA::PETERS <- will be filled in by the system 

Subj: RE: Meeting next fryday 


New mail on node VAXA from VAXA::WILLIAMS 

MAIL> SEND/EDIT 

To: VAXA::PETERS 

Subj: COPY_SELF EXAMPLE 


New mail on node VAXA from VAXA::WILLIAMS 


Example 6-4: Answering a Mail 
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USING SET HOST, 


$ MAIL 

You have 2 new messages. 

MAIL> DIR/FOLDER 

Listing of folders in DISK:[WILLIAMS]MAIL.MAI;1 
Press CTRL/C to cancel listing 
MAIL NEWMAIL 

MAIL> READ 1 


MAIL> MOVE PLANNING 

Folder PLANNING does not exist. 

Do you want to create it (Y/N, default is N)? Y 

%MAIL-I-NEWFOLDER, folder PLANNING created 

MAIL> DIR/FOLDER 

Listing of folders in DISK:[WILLIAMS[MAIL.MAI;1 
Press CTRL/C to cancel listing 

MAIL NEWMAIL 

PLANNING 

MAIL> SELECT PLANNING 
MAIL> DIR 

t From Date Subject 

1 VAXA::PETERS 14-oct-1988 Plan new 


Example 6-5: Using Folders to Store Mails 


PLANNING 

products 
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Using a Distribution List 

First you create a distribution list in the editor or by 
using the CREATE command. Use the file extension .DIS. Include 
for all, the usernames the node if necessary. Using §filename will 
send the message to all the people in the list. 


$ CREATE LIS.DIS 

SSoftware writers 

JOHNSON 

VAXA::CHARLES 

LAWRENCE 

VAXB::ASHLEY 

*Z 

$ MAIL 

MAIL> SEND/EDIT 

TO: @LIS 

SUBJ: Monthly Meeting 


*Z 


Example 6-6: Using a Distribution List 
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Message Files 

A message file is stored as an ASCII text in the default 
logon directory. It contains all the short mailmessages. 

The default message file is MAIL.MAI. 


From: HDV 

To: @GROUP 

Subj: Change of location 


2 3-JAN-8 7 16:23 


Next Tuesday's revieuw meeting has been moved from Conference Room 
A to Conference Room B (on the second floor). See you there. 

» 

From: MENDOZA 34-FEB-87 23:20 

To: READER 

Subj: Payroll Program 

There is a new version of the Payroll Program im my directory: 

[MENDOZAJPAYROLL.FOR;12 


Example 6-7: Example of a MAIL Message File 
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SUMMARY 


With the SET HOST command we can setup a session on a remote 
system, as if the local terminal is directly connected to the 
remote system. In this situation all input from your terminal 
will be send by the local system to the remote system. Two 
processes will be active for servicing your actions. 

The MAIL-command can be used to send information with other 
users on systems somewhere in the network they can read at a 
later moment. 

The PHONE-command can be used to communicate with other 
persons on systems somewhere in the network interactively. 
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CREATING NETWORK PROCESSES 


INTRODUCTION 


To activate a program on another system you need a process. 

In this module the different types of processes, and how to 
create them are discussed. 

OBJECTIVES 

At the end of this module the student will understand the way 
a network process is created. 

RESOURCE 

VAS/VMS Networking Manual 
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CREATING NETWORK PROCESSES 


Communicating programs like any other image that runs on a 
VAX/VMS node, must run within the context of a process. The pro¬ 
cess context defines the environment in which images execute. The 
characteristics of the process allow the VMS software to control 
access and allocate resources for any operation attempted by an 
image running in the process. These characteristics include: 

o Resource quotas 

o Privileges 

o Accounting data 

o Scheduling priority 

o Identification fields 

USER NAME 

- User Identification Code (UIC) 

- • Process Name 

Process Identification Number (PID) 


Process Types 


When a process is created, it is assigned a process type. 
Process types include: 

o Interactive 

o Batch 

o Network 

In this module we shall describe the network process and how 
to create it. 
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Access Control Information 


A network process must be created at the target node to pro¬ 
vide an environment in which the target image can run. DECnet-VAX 
uses access control information (ACI) to determine which account 
provide the characteristics for the network process. 

Access control information, which consists of a user name and 
a password, identifies an account at the target node. 

Once the user name and password are determined at the target 
node, the DECnet-VAX software either passes the request to an ex¬ 
isting network process associated with the proper account, or 
creates a new network process using the characteristics from the 
designated account. 

The information included in the communication request is 
called outbound access control. 


Default DECnet Accounts 

DECnet-VAX provides the network system manager with -the 
option of establishing default DECnet accounts that are used to 
allow communication with a network object without providing 
explicit access control information. Default DECnet accounts, 
like any user account, have entries in the SYSUAF.DAT configura¬ 
tion file. A default DECnet account may be either privileged or 
nonprivileged. The privileged account must be used when the re¬ 
quested target object requires privileges to perform its func¬ 
tions. When the object does not require privileges, the network 
process is associated with the nonprivileged account. 
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OUTBOUND ACCESS CONTROL INFORMATION 

Three types of outbound access control information can be 
sent from the source node: 

o Null access 

o Explicit access 

o No access 

Null Access 


Null access causes an ACI string of null characters to be 
sent to the target node. If a default DECnet account exists on 
the target node, the user can use null access to force a connec¬ 
tion to this account. 

$ DIR SNEEZY""::DISKl:[PUBLIC] 

The null string is sent to the remote node along with the 
process identification number (PID) of the source process. 
DECnet-VAX in the target node associates the nonprivileged 
default DECNET account with the incoming connection request. A 
network process is created with the privileges, priorities, and 
resource availability of this account ([DECNET]). 


Explicit Access Control 


User-supplied explicit ACI is implemented by including the 
target account's user name and password in quotation marks fol¬ 
lowing the node specification in a command or a program state¬ 
ment. For example: 

$ DIR SNEEZY"EARTH MARS"::DISKI:[EARTH] 

When DECnet-VAX recognizes explicit access control, it will 
send the provided user name and password to the target node. The 
communication request also includes the PID of the source process 
to identify the process requesting the logical link. 
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No Access 


The third type of outbound access control information is no 
access. When neither null access nor explicit ACI is used, DEC- 
net-VAX attempts to use proxy access. 

Proxy access is a method of establishing communication with¬ 
out sending access control information with the communication re¬ 
quest . 

When DECnet-VAX at the source node determines that proxy 
access is enabled, it will send no access control information and 
will send the user name of the requesting process instead of the 
PID. 

When the user does not use null access or supply a user name and 
password, and the user does not have a proxy account, DECnet-VAX 
attempts to generate default explicit access control information. 
For example: 

$ DIR SNEEZY::[PUBLIC] 

DECnet-VAX attempts to identify a user name and password for 
a default DECnet account at the target node. The user name and 
password must be listed in an entry for the target node in the 
node database at the source node. The default account can be 
privileged or nonprivileged. 
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ESTABLISHING A LOGICAL LINK 

DECnet-VAX allows two images, each running in a different 
process, to communicate with each other. A. program that can 
communicate over the network is called an OBJECT. 

Por this communication to take place, the images must estab¬ 
lish a connection to allow control and data messages to be ex¬ 
changed. This connection is called a logical link. 


Figure 7-1: The Logical Link 


SOURCE 
NODE 


LOGICAL 

LINK 


TARGET 

NODE 
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Figure 7-2: Establishing the Logical Link (Outbound) 
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Figure 7-3: 
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If there is no network process created to accept the logical 
link request, DECnet creates a new netserver process to handle 
the connection. The user name and password obtained by processing 
the inbound access control information identify the account to by 
used to determine the attributes of the new network process. The 
following steps describe the netserver process creation. 

o DECnet issues a $CREPRC system service call, which passes 
control to LOGINOUT.EXE 

o LOGINOUT performs the following functions: 

opens SYSUAF.DAT 
creates a process 
creates a logfile 
passes control to DCL 

o DCL performs the following functions: 

executes system login command file 
executes user's login command file 
- passes control to NETSERVER.COM 

O NETSERVER.COM starts NETSERVER.EXE 


After the logical link is disconnected, the NETWORK process 
in which it was running becomes idle. The netserver process re¬ 
mains in this wait state for a period of time defined by a time¬ 
out parameter called NETSERVER$TIMEOUT; after that period it is 
deleted. 
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SUMMARY 


A NETWORK process will be created, when we activate a program 
on another system in the network, to create this NETWORK-process 
the system uses the user-specified login-information, a username 
and a password. 

The remote system uses the username to create a NETWORK pro¬ 
cess with the characteristics specified in the SYSUAF.DAT file. 

When the user does not specify login information, the NETWORK 
process will be created on account of the OECNET-account (if 
there is any). 

After a specified period of inactivity the NETWORK-process 
will die. 
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REMOTE FILE ACCESS 


INTRODUCTION 


In this module will be discussed how to use the different DCL 
commands to access files on remote systems. This includes how to 
print a file on a remote system, how to execute a file on a re¬ 
mote system, and how to open and close a file on a remote system. 


OBJECTIVES 


At the end of this module the student will be able to use the 
different DCL commands to access resources and files on remote 
systems. 


RESOURCES 


Guide to Using DCL and Command Procedures on VAX/VMS 
VAX/VMS Networking Manual 
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THE COMMUNICATING PROGRAMS 


Remote file access is an example of two programs in different 
nodes communicating with each other. In Figure 8—1, the programs 
are RMS at the source node and the File Access Listener (FAL) at 
the target node. 


Figure 8-1: Remote File Access Communicating Programs 


LOGICAL 

LOCAL NODE LINK REMOTE NODE 



RMS is the file and record subsystem of the VAX/VMS operating 
system. It provides the user with access to the file system on 
the local node as well as access to file systems at remote nodes. 

FAL is a DIGITAL-supplied network object that provides 
authorized access to the file system of a DECnet node on behalf 
of processes executing on any node in the network. FAL resides in 
the Application layer of the DECnet architecture. The FAL object 
is always defined as object number 17 in the object database of a 
DECnet node. 
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THE NODE SPECIFICATION 


Including a node specification in a command or program state¬ 
ment causes RMS to initiate remote file access through the DEC- 
net-VAX software. 

$ TYPE VAXA::DISK2:[ROMAN]TEST.FIL 

The node specification may optionally include explicit access 
control information used at the remote node to determine the 
account used to create the netserver process in which the FAL 
object is run. 

$ TYPE VAXA"ROMAN ROBOT"::DISK2:[ROMAN]TEST.FIL 

This command causes the netserver process created at node 
VAXA to possess the attributes of the user account ROMAN. 

VAX/VMS allows you to assign a logical name to represent the 
node specification in a DCL command or program statement. Using 
logical node names allows you to use a network node specification 
in a DCL command procedure or program statement without entering 
the specific node name and access control information. 

An advantage of using a logical node name is security. You 
can access a specific account on a remote node without specifi¬ 
cally stating the user name and password of that account in your 
program. 

The following examples show the use of logical names to re¬ 
present the node specification portion of file specifications. 

§ DEFINE SWAN "SWANZY""ROMAN ROBOT""::" 

$ TYPE SWAN::DISK2:[ROMAN]TEST.FIL 

Logical node names can also be used in program statements as 
in the following FORTRAN OPEN statement. 

$ DEFINE REMOTE_NODE "SWANZY""ROMAN ROBOT""::" 

$ RUN SOURCEPROG 

Where SOURCEPROG.FOR contains the statement: 

OPEN (UNIT-1, NAME-'REMOTE NODE::TEST.FIL' _) 
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REMOTE FILE ACCESS OSING DCL-COMMANPS 


We can access files by using normal DCL-commands. 


APPEND 

$ APPEND VAXA"USER PASSWORD"::FILEl.TMP 
To: VAXB"USER2 PASSW"::FILE2.TMP 


COPY 

$ COPY FILEl.BASIC 

To: PDPA"RSXUSER PASSWORD"::FILE.XYZ 
DELETE 

§ DELETE VAXA::*.TMP.*/LOG 

TYPE 

$ TYPE PDPA"USER PASSWORD"::NEXT.FILE 

« 

CREATE 

$ CREATE VAX::FILE.NEXT 

LINE1 

LINE2 

LINE3 

DIRECTORY 

$ DIRECTORY VAX:: 

Directory VAX::USE_DISK:[DECNET] 

NETSERVER.LOG;2027 NETSERVER.LOG;2026 TEST.TST;1 

TTJl.DAT;1 TTK4.LIS;4 TTK4.LIS;3 

Total of 6 files. 
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THE NETSERVER.LOG FILE 


The logfile created during creation of the network process is 
NETSERVER.LOG. 

This file contains a copy of the login command files executed 
during process creation, a copy of the NETSERVER.COM file, and 
information about each connection request received by the net- 
server process. The command sequence shown in example 8-1 leaves 
us the logfile shown in example 8-2. 


$ DEFINE REVAXA "VAXA""USER PASSWORD""::" 

$ 

$ DIR REVAXA:*.TXT 

Directory VAXA"USER password"::USE_DISK:[USER] 

TEXT.TXT;1 EXPL.TXT;1 

Total of 2 files. 

$ 

$ TYP REVAXA:TEXT.TMP 
This is the file text.tmp 
mumble mumble mumble 
"2 
$ 


Example 8-1: Using DCL Commands for remote file access 
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$ mode - F$VERIFY(0) 

§ 

$loginfile: 


mode - F$VERIFY(mode) 

if f$search("LOGIN.COM”) .nes. then @login 

! LOGIN.COM 
! 

! My user-LOGIN.COM 
! 

IF ( F$MODE() .EQS. "NETWORK” ) THEN GOSUB NET 

NET: 

SHOW PROCESS 


4-AUG-1987 11:03:09.20 User: USER 

id: 20400B5E Proc. name: FAL_3097 UIC: [LOCAL,USER] 

riority: 4 Default file spec: USE_DISK:[USER] 

RETURN 

IF ( F$MODE() .EQS. "BATCH” ) THEN GOSUB BATCH 

IF ( F$MODE() .EQS. "INTERACTIVE” ) THEN GOSUB INTER 

EXIT 

IF "" .NES. "" THEN NETSERVER$COMMAND 
IF .EQS. "" THEN NETSERVER$VERIFY - 0 

V - F$VERIFY(NETSERVER$VERIFY) 


Connect request received at 14-AUG-1987 11:03:12.05 ' 

from remote process VAXB0-JOHNSON " 

for object "SYS$COMMON:[SYSEXE]FAL.EXE" 


Connect request received at 14-AUG-1987 11:03:18.40 
from remote process VAXB::”0-JOHNSON ” 

for object "SYS$COMMON:[SYSEXE]FAL.EXE" 


USER job terminated 
Accounting information: 
Buffered I/O count: 
Direct I/O count: 

Page faults: 

Charged CPU time: 0 


at 14-AUG-1987 11:08:20.17 


235 

132 

3028 

00:00:08.94 


Peak working set size: 298 

Peak page file size: 1265 

Mounted volumes: 0 

Elapsed time: 0 00:06:46.05 


Example 8-2: NETSERVER.LOG file 
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REMOTE COMMAND PROCEDURE EXECUTION 


To submit a command procedure on a remote node the specified 
procedure has to reside at one of the disks on the remote node. 

Not all of the SUBMIT qualifiers are compatible with /REMOTE. 
Only the following qualifiers may be specified with /REMOTE: 
/BACKUP, /BY_OWNER, /CONFIRM, /CREATED, /EXCLUDE, /EXPIRED, 
/MODIFIED, and /SINCE. 

When the command procedure executes, all output is written to 
a log file on the node and in the account where the file resides. 
By default the log file specification consists of the file name 
of the command procedure and the file type LOG; the file will be 
deleted after printing. 


$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 


» DCLTEST.COM - a command procedure used to demonstrate 
! DECnet remote command procedure execution 

t 

START: 

SHOW PROCESS 

END: 

! 

EXIT 


Example 8-3: Command procedure DCLTEST.COM 
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$ mode 

$ 

$loginfile: 

$ 

$ mode 

$ if 

$! LOGIN.COM 


F$VERIFY(0) 


- F$VERIFY(mode) 

f$search("LOGIN.COM") .nes. "" then ©login 


$! 

$1 This is my LOGIN.COM 
$! 

$ IF ( F$MODE() .EQS. "NETWORK" ) THEN GOSUB NET 

$ IF ( F$MODE() .EQS. "BATCH" ) THEN GOSUB BATCH 

$ BATCH: 

$ RETURN 

$ IF ( F$MODE() .EQS. "INTERACTIVE" ) THEN GOSUB INTER 

$ EXIT 


$ l DCLTEST.COM - a command procedure used to demonstrate 
$ l DECnet remote command procedure execution 
§ ! 

$ START: 

$ SHOW PROCESS 

13-AUG-1987 16:29:22.81 User: USER 

Pid: 20400AB9 Proc. name: BATCH_532 UIC: [LOCAL,USER] 

Priority: 1 Default file spec: USE_DISK:[USER] 

$ 1 

$ EXIT 


USER job terminated at 13-AUG-1987 

Accounting information: 

Buffered I/O count: 38 

Direct I/O count: 39 

Page faults: 536 

Charged CPU time: 0 00:00:02.27 


16:29:23.59 

Peak working set size: 337 

Peak page file size: 1215 

Mounted volumes: 0 

Elapsed time: 0 00:00:27.49 


Example 8-4: Logfile 


of the Batch command procedure DCLTEST.COM 
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REMOTE PRINTING 


When printing a file on a printer on system AAA the file must 
be located on one of the disks of system AAA. 

You always have to specify the qualifier /REMOTE. If this quali¬ 
fier is specified, the file is queued for printing in the default 
queue of the node on which the file exists. 

N 2 t n a1 ^ PRINT . qualifiers are compatible with /REMOTE. Only 
the following qualifiers may be specified with /REMOTE: /BACKUP, 
/BEFORE, /BY_OWNER, /CONFIRM, /CREATED, /EXCLUDE, /EXPIRED, 
/MODIFIED, and /SINCE. 

$ PRINT/REMOTE VAXA::FILE3.TXT 

If the file is not yet on the remote system you have to copy 
the file first, before printing it. 

$ COPY FILE3.TXT VAXA::FILEREMOTE.TXT 

$ PRINT/REMOTE VAXA::FILEREMOTE.TXT 
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ACCESSING REMOTE FILES USING DCL COMMAND PROCEDURES 

DCL command procedures executing at the local node can con¬ 
tain DCL commands that access files residing on remote nodes. 

Like all commands that request remote file access, these commands 
must contain a node specification identifying the node where the 
file resides. 


$ ! REMSEQFILE.COM - Command procedure to read all the record 
$ i of a sequential file on a remote node and 

§ j type them to the terminal on the local node 

§ ! 

$ 1 

$ OPEN/READ REMOTE NOOT"USER PASSWORD"::TEST.FIL 

$ i 

$ READ LINE: 

$ READ/END_OF_FILE-EOF REMOTE LINE 

$ 1 

$ WRITE SYSSOUTPUT LINE 

$ ! 

$ GOTO READ_LINE 

$ l 

$ ! End of file routine 
$ ! 

$ EOF: 

$ CLOSE REMOTE 

$ EXIT 


Example 8—5: DCL Command procedure REMSEQFIL.COM 
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SUMMARY 


The DCL-commands for file handling are also available for 
handling files at remote nodes. The file specification has to 
specify the nodename and a username/password to create a NETWORK 
process to handle the file at the remote system. 

The file EXAMPLE.DAT on remote node VAXA in the directory 
[STUDENT] can be accessed by the filespecification VAXA"STUDENT 
PASSWORD"::[STUDENT]EXAMPLE.DAT;1 

All activities at the remote node on account of the created 
NETWORK-process are logged in the file NETSERVER.LOG in the de¬ 
fault directory of the specified account. 

To use the PRINT and SUBMIT-command at a remote node you have 
to specify the REMOTE qualifier. 
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OBJECTS 


INTRODUCTION 


In this module is discussed what kind of 
communicate over the network. These programs 


programs are used to 
are called OBJECTS. 


OBJECTIVES 


At the end of this module the student will be able to write a 
Zero-Object, a DCL-command procedure, and understand how this ob¬ 
ject can cooperate with a procedure on the local system. 


RESOURCES 


Guide to Using DCL and Command Procedures on VAX/VMS 
VAX/VMS Networking Manual 
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OBJECTS 


A program that can communicate over the network is called an 
object. Objects can be either user-written or supplied by 
DIGITAL. They are identified by object type (number) and name. 
Before an object can receive any communication requests, it must 
identify itself to the DECnet software on its node. The object 
parameters are included in an object database that is accessed by 
DECnet-VAX whenever it receives a communication request. The 
parameters that can apply to an object include: 


o An object number 

o The file to be executed when the object is requested 
o Privileges required to connect to the object 
o PROXY enabled or disabled 

o Optional default access control for inbound connects 


PROXY and access control information are discussed in module 
7 of this course. 

A source program uses an object type to identify the target 
object with which it wishes to communicate. 

Objects are divided into two general types: 


o Zero (0) Objects 
o Nonzero Objects 


User-written objects are most of the time not entered in the 
object database. They are objects in the category of the zero- 
objects. They are called by using the TASK-object, which is de¬ 
fined in the object database as a zero-object. 

Nonzero objects are known objects that are identified in the 
object database by their object type number. Object type numbers 
for nonzero objects range from 1 to 255. 

DIGITAL reserves the range of nonzero object numbers between 
1 and 127 for DECnet system objects. The remainder of the nonzero 
object types (128-255) are available to identify user written 
programs. 
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Table 9-1: DIGITAL 

Supplied Object Types 

Object Number 

Object name 

0 

TASK 

17 

FAL - File access listener 

18 

HLD - Host loader 

19 

NML - Network management listener 

23 

REMACP 

25 

MIRROR - Loopback mirror 

26 

EVL - Event logger 

27 

MAIL 

29 

PHONE 

42 

CTERM 

63 

DTR - DECnet test receiver 
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EXAMPLE OF A ZERO OBJECT 


A zero object can be a user written program or command 
procedure that uses the network. When we want two programs to 
communicate across the network a logical link must be created. 

When a source program initiates a logical link request, it 
identifies the remote node and the remote task with which to com¬ 
municate. The remote node is specified in the node specification 
string. Since the remote task is an object type 0, the object 
name must be supplied in the task specification string. 

The task specification string is a quoted string that identi¬ 
fies the remote task to which you attempt a logical link connec¬ 
tion. It must be included in the program statement used to initi¬ 
ate the logical link. 

"TASK-taskname" 

"0-taskname" 

Note that 0 and TASK are equivalent. The task name can be 
from 1 to 16 characters and represents the filename of a command 
procedure to be executed in the netserver process at the remote 
node when the logical link is initiated. 


$ ! 

$ ! SOURCE.COM 
$ ! 

$ INQUIRE STRING "Enter string: " 


$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 


WRITE LINK STRING 


WRITE SYS$OUTPUT COUNT 


OPEN/WRITE/READ LINK VAX"USER PASSWORD"::"TASK-TGT" 


READ LINK COUNT 


CLOSE LINK 


EXIT 


Example 9-1: DCL Source Program SOURCE.COM 
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OBJECTS 


I 


I 

I 

! 

! 


t 

! 


TGT.COM 

OPEN/WRITE/READ LINK SYS$NET 

READ LINK STRING 

COUNT - F$LENGTH(STRING) 

WRITE LINK COUNT 

CLOSE LINK 

EXIT 


Example 9-2: DCL Target Program TGT.COM 
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SUMMARY 


A program used in a communication over the network is called 
an OBJECT. A user written.program, used to communicate with a 
program at another system can have a so called objectnumber, 
128-255. 

A network program supplied by DEC has an objectnumber 
0-127. 

To start an object at a remote node you have to specify the 
object name or number in the task specification string. For 
instance, to activate the command procedure EXAMPLE.COM at the 
node VAXA in the default directory you have to specify: 
VAXA::"TASK-EXAMPLE" 
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X.25 AND X.29 NODULES 


INTRODUCTION 


The Packetnet System Interface (PSI) is designed to communi¬ 
cate with another system over a PPSN. 

Using NCP you can display the different parameters that influence 
the function and performance of PSI. 

In this module will be discussed what are the functions of 
the different software modules you can display with NCP. 


OBJECTIVES 


At the end of this module the student will understand the 
function of: 

o the X.25 protocol module 

o the X.25 server module 

o the X.25 access module 

o the X.29 server module 

and understand how to display the parameters for these modules. 
RESOURCES 

VAX/VMS Networking Manual 

VAX/VMS Network Control Program Reference Manual 
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PSI OVERVIEW 

The Packetnet System Interface (PSI) is designed to follow 
the recommendations produced by the CCITT. 

The major advantages of packet networks include cost savings 
for medium traffic, rates independent of distance, flexibility, 
network management provided by the value-added carries, and an 
ability to communicate with other vendor's equipment. 


THE X.25 RECOMMENDATION 


The end user does not need to know anything about the inter¬ 
nal mechanism in Public Packet-Switched Networks (PPSN). Users 
may treat the PPSN as a magic cloud. 

The X.25 recommendation specifies the protocols used to com¬ 
municate between the local system and the network interface. 

The local system is referred to as the Data Terminal Equip¬ 
ment (DTE). 

There are two types of DTEs: 

o Packet-Mode DTEs (generally a computer system) 

o Start/Stop Mode DTEs (generally an asynchronous user 
terminal) 


The network interface is called the Data Circuit Terminating 
Equipment (DCE). 
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The recommendation defines three levels 
which apply to the single physical link that 
the network interface (DCE). They are: 


(layers) of protocol 
connects the DTE to 


o level 3, packet level 

o level 2, link level 

o level 1, physical level 


n»ni,IiI Ure /P’ 1 sh ° ws how user data is made into a packet or 
packets, and how packets are made into frames. 

nar.ir»J Vel .FK 3 acc ®P ts data and adds a packet header to form a 
Pf? ket header contains the logical channel number, 

control information. ° f ^ ^ * ls ° have ° ther 


arr«i! Ve i - 2 iS * es P onsibl e for transferring packets without 
® llul* b ? twean the DTE and the DCE. It does this by enclosing 
packets in frames. Two sets of procedures for link control are' 
aerinea in C.25: 


o LAP (link access procedure) 

o LAPB (link access procedure balanced) 


The CCITT have based LAP on the HDLC protocol. The CCITT mod- 

lnir d I£ P 5° LAPB J to ® ak ? U compatible with a later version of 
Tbe DTE neec * only implement one set of procedures (LAP or 

LAPB ) • 

* ^ controls the physical transmission between the DTE 

ana tne DCE. 
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Figure 10-1: User 


USER LEVEL 


PACKET (LEVEL 3) 


FRAME (LEVEL 2) 
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1 


Virtual Circuits 


. Wh * n t y° u U P a cal l to a remote DTE, you are creating a 

nhDsira? tW ?® n i, t ? e tW K- ? TEs * In a Packet switching network, the 
J 1 *. link fi on9 which packets are sent is not specified. The 
link between the DTEs is a logical rather than a physical one. 
The logical link from a program on the local DTE to a program on 
a remote DTE is called a virtual circuit. 


The packet switching software defines a number of channels, 
so that one physical line can be shared by more than one virtual 
circuit. The channels are called logical channels. Each channel 
is identified by a number called a logical channel number (LCN). 


When a virtual circuit is created, the local DTE assigns one 
of the logical channels. Every packet which is sent over that 

C T 1 If, U - fc then contain the LCN of the logical channel 
used. The LCN is held as part of the packet header and is used to 
determine the address to which the packet is sent. 


The local DCE identifies the virtual circuit from the logical 
channel, and determines which remote DCE the packet is sent to. 
The remote DCE assigns a logical channel to the remote DTE at the 
other end of the virtual circuit. The remote LCN and the local 
LCN are usually different. 

Figure 10—2 shows a DTE which has three virtual circuits. One 
circuit uses separate logical channels to send data across the 
physical link to the DCE. There is a logical channel at each end 
°* the virtual circuit, and these channels are independent of 
each other. 
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The virtual circuit between two DTEs may be temporary 
(switched), or permanent. 

o Permanent Virtual Circuit (PVC) 

If a circuit is permanent, it is similar to a leased line 
between the local DTE and the remote DTE. In a public 
network, logical channels are permanently assigned to the 
virtual circuit by the network authorities when the user 
subscribes to the network. 

o Switched Virtual Circuit (SVC) 

A switched virtual circuit is similar to a dial-up line. 
The virtual circuit is created only when there is data to 
transmit, and it is cleared when the transfer is com¬ 
plete. The user at the local DTE sends a Call Request 
packet containing the address of a remote DTE. This 
causes the X.25 software to assign a logical channel and 
create a SVC. 


The time taken to set up a call depends on whether the two 
DTEs which need to communicate are connected by a PVC or an SVC. 
A PVC connection means that there is no call setup time. SVCs are 
more flexible, allowing a DTE to communicate with any other DTE 
in the PSN. 
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Figure 10-2: Two-Node Configuration 


VIRTUAL SUB 



Notes on Figure 10-2: 

o TA calls Tl using remote subaddress 11 

TB calls T2 using remote subaddress 12 

TC calls T3 using remote subaddress 13 

o Tl, T2, and T3 respond using the incoming call identifica¬ 

tion data in the NCB 

o Note that the channel numbers at each end of a virtual 
circuit are independent 
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DTE ADDRESSING 


Each DTE connected to a PPSN is assigned an address. The 
addresses are totally unique across all PPSNs worldwide. During 
connection time the address of the remote DTE is specified in the 
Call Request packet. For PVCs the address of the remote DTE is 
specified at subscription time. 

The addresses are specified as four-bit BCD numbers and can 
be up to 12 or 14 digits in length. The first four digits identi¬ 
fy the PPSN, the so called Data Network Identification Code. Up 
to eight additional digits following the DNIC identify an indi¬ 
vidual DTE within the PPSN. Up to four additional digits follow¬ 
ing the DTE address identify a subaddress. 
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THE X.29 RECOMMENDATION 


. T ^ e X.3, X.28, and X.29 recommendations toqether soeeifv hnu 

work COn Toaethf? nC ^° nOUS terminals connected di?ectly to th^net- 
?nt«face 9 U?n. Protocols define the interactive Term?n£l 


Figure 10-3: X.3, X.28, and X.29 Protocols 


X.25 DEFINES 





Notes on Figure 10-3: 


X.3 


Packet Assembly/Disassembly (PAD) facility in a pub 
lie data network. v 


X.28 


X.29 


DTE/DCE interface for start-stop mode Data Terminal 
quipment (DTE) accessing the Packet Assembly/Disas¬ 
sembly (PAD) facility in a public data network situ¬ 
ated in the same country. 


Procedures for 
and user data 
facility. 


the exchange of control information 
between a packet-mode DTE and a PAD 
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HARDWARE REQUIREMENTS FOR AN X.25 CONNECTION 


When you want to connect to another system using X.25 you 
need a synchronous device, or synchronous port on a controller. 

To get the names of the available controllers at the moment 
you need them, use to the Nfetworks and Communications Buyer's 
Guide. 

The interfaces available according to the Buyer's Guide of 
1988 July-September are: 

KMVlA for a Microbus machine 
DMB-32 for the Bi-bus 
DMJ8^32 for the Unibus 
KMS11 for the Unibus 
DUPll for the Unibus 
KMSlP for the Unibus 
DST32 for a MicroVAX 2000 


So, to use the X.25-software you need a synchronous line 
(Example 10-1). 

NCP>SHOW LINE DUP-0 CHAR 


Line - DUP-0 


Receive buffers 
Controller 
Duplex 
Protocol 

Retransmit timer 

Maximum block 

Maximum retransmits 

Maximum window 

X.25 line interface mode 

Network 


14 

normal 

full 

LAPB 

2000 

4101 

20 

7 

DTE 
TRY IT 


Example 10-1: A Synchronous Line Used for X.25 
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X.25 AND X.29 MODULES 

There are three types of X.25:X.29 modules: 
o X.25 Protocol Module 

o X.25 Server and X.29 Server module 

o X.25 Access module 
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X.25 PROTOCOL MODULE 


The x. 25 protocol module is the software component that 
controls the transmission of data packets over PSDNs. The 
database for the X.25 protocol module identifies the networks to 
which your DTEs are connected, defines the DTEs and specifies any 
user group to be associated with the DTEs. 

Note that the term 'network name' in this context does not 
refer to a PSDN, but rather to a route to a PSDN. 

Make sure that the profile-name is the correct one, if you 
want to connect to a public data network. 

In the database the values of parameters that affect data- 
packet control. Defaults set the size and control the flow of 
data-packets over switched virtual circuits, and control setup 
and clearing of these circuits. 

Your local DTE is identified by the DTE address and network 
name. 


NCP> SHOW X25-PROTOCOL KNOWN DTE 


Module 

X25-Protocol Volatile 

Summary as of 12-OCT-1988 

14:21:45 


DTE 

Network 

State 

Active 

Channels 

Active 

Switched 

1234 

TRYIT 

on -running 

1 

1 

3542 

EDUNET 

on -running 

1 

1 


NCP>SHOW X25-PROTOCOL KNOWN NETWORKS CHARACTERISTICS 

Nodule X25-Protocol Volatile Characteristics as of 12-OCT-1988 14:24:13 


Network - TRYIT 

Profile - ISO8208 


Network - SECOND 

Profile - EDUNET 


Example 10-2: Using NCP to Display the X.25 Protocol 

Characteristics 
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X.25 SERVER / X.29 SERVER MODULE 


To handle calls coming in over a PSDN from remote DTES and 
terminals, the X.25 and X.29 server modules are needed ?hesf 
“° ues ^ten referred to as call handlers ?h2x 25 server 
thf Ul £ ,5 andles in o°® in 9 calls that originated at a remote DTE; 
a rem^e teriinll handles incoming calls that originated at 

The configuration database for the server modules defines the 
processes that are the destinations for calls, so that incoming 
calls from a PSDN can be directed to the appropriate destination? 

he server database specifies the maximum number of circuits the 
s S * rv ! r f module may have, that is: the maximum number of incoming 
and outgoing calls that all destinations can handle. 9 


NCP>SHOW X25-SERVER CHARACTERISTICS 

Module X25-Server Volatile Characteristics as of 12-OCT-1988 14:24:16 
Maximum circuits - 255 

NCP>SHOW X29-SERVER CHARACTERISTICS 

Module X29-Server Volatile Characteristics as of 12-OCT-1988 14:24:40 
Maximum circuits - 16 


Example 10-3: X.25 and X.29 Server Characteristics 
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When you specify a subaddress in connecting a X.25-system, 
then the X.25-protocol module will check validity of the packets, 
and will direct the informationstream to the X.25-SERVER module. 

There the subaddress field will be used to route you to the 
desired destination. 

Look at example 10-4. If you are somewhere in the network, 
and you want to connect to the node NEWNOD, you first must spec¬ 
ify the DTE number of the PSI-multihost node. The X.25-SERVER 
CHARACTERISTICS of this node are displayed in example 10-4. 

If the DTE number of the multihostnode is 12345, you must 
specify a subaddress in the range 10-15. In this example we shall 
take 14. Then the X.25-SERVER at the multihost node will route 
you through (using DECnet) to the node NEWNOD. 

At the node NEWNOD the software PSI-ACCESS must be installed 
to talk to PSI at the multihostnode with DTE number 12345. 

The address you specify for node NEWNOD will be 1234514. 


NCP> SHOW X25-SERVER KNOWN DESTINATIONS CHARACTERISTICS 


Module X25-Server Volatile Characteristics as of 12-OCT-1988 14:24:59 


Destination 

Node 

Object 

Priority 

Subaddresses 


- NODEX 
-40.1 (NODEX) 

- 36 

- 200 
- 6-10 


Destination 
Object 
Priority 
Call mask 
Call value 


PSI_MAIL 

PSI_MAIL 

100 

FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 

FF00000056332E30204D41494C2D3131 


Destination 

Node 

Object 

Priority 

Subaddresses 


NEWNOD 

40.3 (NEWNOD) 
36 
200 
11-15 


Destination 
Priority 
Call mask 
Call value 


X29_SERVER 

127 

FF 

01 


Example 10-4: The Destinations of the X.25 Server Module 
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X.25 ACCESS MODULE 


The X.25 access module provides a means for user processes on 
VAX/VMS host nodes to access remote nodes or terminals connected 
to a PSDN through a VAX/VMS node serving as a multihost connector 
node. The host node must be configured with VAX PSI software in 
multihost mode. The X.25 access module identifies the connector 
node to which the local node is to be connected and the network 
the connector node can access. 


NCP> SHOW X25-ACCESS KNOWN NETWORKS CHAR 

Module X25-Server Volatile Characteristics as of 12-OCT-1988 14:26:43 

Network - TRY1T 

Node - 40.40 (NODEA) 


Example 10-5: The X.25 Access Characteristics 
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USING THE X25-NETWORK 

When you have the PSI-software installed, you can use it, 
The most common used commands are SET HOST/X29 and MAIL. 


SET HOST/X29 

TO use SET HOST across an X25-network you must use the quali¬ 
fier /X29. Then the host based PAD will be used. These has the 
parameter settinqs, specified by the CCITT specification X.3. 

To set up a remote terminal session you have to specify the 
command SET HOST/X29. 

To use the SET HOST/X29 command you first need to know what 
is the default datanetwork the PSI-software will choose. 

For that reason you '11 have a look at the logical 

PSI$NETWOR^ tem you want to connect to is not in the network 

specified by the logical PSI$NETWORK, you must prefix the DTE- 
number by the correct NETWORK-name. 

in the next example the system you want to connect to is con¬ 
nected to the network EDUNET, DTE-number 3542. 

If our node is connected to both networks, we can connect t 
it using the command SET HOST/X29 EDUNET%3542 (Example 10-6). 


$ SHOW LOGICAL PSI$NETWORK 
"PSI$NETWORK" - "TRYIT" 

$ SET HOST/X29 EDUNET%3542 


(LNM$SYSTEM_TABLE) 


WELCOME TO NODE ALLRIG 


Username: 


Example 10-6 Using SET HOST/X29 to an Other Network 
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MAIL 


To use MAIL across the X25-network you must specify the DTE- 
number of the destination node before the number prefixed by the 
expression PSI%. 

To address the user PETERS on the node with DTE-number 12345 
the destination address will be PSI%12345: :PETERS. 


MAIL> SEND 

To: PSI%12345::PETERS 

Sub j : the answer is .... 


Example 10-7 Sending a Mail Using PSI 


MAIL> 

You have 1 new message. 

MAIL> READ 1 

From: PSI%TRYIT.<no-node>::SYSTEM 

To: PSI%12345::WILLIAMS 

Subj: New systems next month 


NEWMAIL 


Example 10-8 Receiving a Mail 
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HATALINK MAPPING 


You can also use the datanetwork to use DECnet across it. 
Then all the normal DECnet traffic will use the X2 5-network. 

Also Hello-messages will be sent across the s0 

the normal DECnet functions can be used across the network, 
the normal SET HOST and MAIL commands can be used. 


NCP> SHOW KNOWN CIRCUITS 

Known Circuit Volatile Characteristics 

UNA-0 on 

X25-DLM on 


as of 18-OCT-1988 13:23:44 

40.18 (VAXQ) 
40.11 (MOUSE) 


NCP>SHOW CIRCUIT X25-DLM CHARACTERISTICS 


Circuit - X25-DLM 

State 

Cost 

Hello timer 

Maximum recalls 

Recall timer 

Number 

Owner 

Usage 

Type 

Verification 
Adjacent node 
Listen timer 


* on 

* 10 

* 15 
« 100 
- 60 

- 30111 

* Executor 

- outgoing 

- X. 25 

- disabled 

- 40.11 (MOUSE) 

- 30 


Example 10-9 A DLM-circuit to Node MOUSE 
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SUMMARY 


To communicate over a PPSN we need some specific software. We 
need an X.25 Protocol module, which imnplements the X.25 proto¬ 
col, an X.25 call handler: the X.25 Server module, and if neces¬ 
sary an X.25 Access module. 

To setup a remote terminal session over a PPSN we need an 
X.29 server module. 

With the NCP we can look at the characteristics and param¬ 
eters needed to create a communication channel to another system 
over the PPSN. 

To use the X.25-network we can us the SET HOST/X.29 command 
and the MAIL command. 
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DATABASES 


INTRODUCTION 


In this module is discussed how the network parameters are 
stored. For this purpose the network uses some databases. 

In this module the different types of database are discussed, 
and the way to put information in the databases, to change infor¬ 
mation in the database and to read the information in the data¬ 
base . 


OBJECTIVES 


At the end of this module the student will understand which 
databases are used and how to manipulate to information in the 
databases. 


RESOURCES 


VAX/VMS Network Control Program Reference Manual 
VAX/VMS Networking Manual 


11-1 
















DATABASES 


DATABASES 

DECnet-VAX maintains databases to contain parameter informa 
tion that . the local node needs to participate in the network 
There are three types of databases: 

o Volatile database 
o Permanent database 
o PSI database 
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Volatile Database 


The volatile database, maintained by NETACP, is a memory res¬ 
ident database containing current network configuration parame¬ 
ters. To manipulate and look in this database use the NCP SET, 
SHOW and CLEAR commands. 

To read the volatile database we use the NCP SHOW command. To 
use this command we need no special privilege. 


NCP> SHOW KNOWN OBJECTS 

Known Object Volatile Summary as of 6-NOV-1988 12:02:18 
Object Number File/PID User Id 


$MOM 

0 


$NICONFIG 

0 


SMISERVER 

0 

2020010C 

FAL 

17 

FAL.EXE 

HLD 

18 


NML 

19 

NML.EXE 

REMACP 

23 

2020010F 

MIRROR 

25 


EVL 

26 

2020010E 

MAIL 

27 

MAIL SERVER.EXE 

PHONE 

29 

PHONE.EXE 

CTERM 

42 

202001 OF 

DTR 

63 


PCFS 

64 



Example 11-1: Using NCP to read the volatile database 
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To change or set a parameter in the volatile database we use 
the NCP SET command. For this command the OPER privilege is 
needed. 


NCP> SET CIRCUIT UNA-0 COST 6 
NCP> SHOW CIRCUIT UNA-0 CHAR 

Circuit Volatile Characteristics as of 17-AUG-1987 09:45:26 
Circuit - UNA-0 


State 

Service 

Designated router 
Cost 

Router priority 
Hello timer 
Type 

Adjacent node 
Listen timer 


on 

enabled 
4.23 (VAXA) 
6 

64 

15 

Ethernet 
4.17 (VAXE) 
45 


Example 11-2: Using NCP to modify the volatile database 

There is a special case of the NCP SET command. The SET 
<comp> ALL command is used to update the volatile database with 
all the parameters of the <comp> stored in the permanent data¬ 
base. To use the NCP SET xxx ALL command you need SYSPRV. 

To clear network parameters or reset them to the default 
values we use the NCP CLEAR command. To use the CLEAR command we 
need OPER privilege. 

NCP> CLEAR CIRCUIT UNA-0 ALL 
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Permanent Database 


The permanent database contains all the parameter information 
that the local node needs to function. The parameters set by the 
user or network manager are registered in the following files on 

ai&lr? J 


NETCIRC.DAT 
NETCONF.DAT 
NETLINE.DAT 
NETLOGING.DAT 
NETNODE_LOCAL.DAT 
NETOBJECT.DAT 
NETX25.DAT 
NETX29.DAT 
NETNODE_REMOTE.DAT 
NETPROXY.DAT 


To set, change and read parameters in the permanent database 
we use the NCP DEFINE, PURGE and LIST command. For these commands 
the system privilege (SYSPRV) is required. In table 11-1 the 
files, containing the parameters, are listed. 
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Table 11-1: The Permanent Database Files 


Filenaam 

Contents 

NETCIRC.DAT 

Contains all the non-default values of the 
circuit parameters. 

NETCONF.DAT 

Contains the non-default parameter values for 
the ETHERNET module configurator. 

NETLINE.DAT 

Contains all the non-default values of the 
line parameters. 

NETLOGING.DAT 

Contains all the non-default parameters for 
the logging. 

NETNODE_LOCAL.DAT 

Contains all the non-default parameter values 
for the local host (executor). 

NETOBJECT.DAT 

Contains all the non-default parameters in the 
object database. 

NETX25.DAT 

Contains the non-default parameters of the 
X.25 server module and X.25 protocol module. 

NETX29.DAT 

Contains the non-default parameters of the 
X.29 server module. 

NETNODE_REMOTE.DAT 

Contains the local defined node characteris¬ 
tics of other nodes. 

NETPROXY.DAT 

Contains the defined proxy names. In VMS V4.* 
the name of the file was NETUAF.DAT. 
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PSI Database 


Each PSI DTE that is connected to a PSDN has a database that 
nm? pll ? S c ° m P? nent a ? d parameter information concerning the local 
DTE, local lines, virtual circuits, local modules, and local ob- 
jects. 

The VAX PSI configuration is also stored in the DECnet-VAX 
configuration. Just as with the DECnet-VAX configuration data¬ 
base, the VAX PSI configuration database consists of both a vola¬ 
tile and a permanent database. 
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SUMMARY 


When the network is up and running, it stores several charac- 
teristics and counters in a database in memory: the volatile 
database. This database we can look at by using the NCP utility. 

To get the initial parameter settings at startup time, the 
network 9 looks at another database, which consists of several 
files on disk: the permanent database. 

To get the information for setting up the network for access¬ 
ing a PPSN the PSI database is used. This database consists of a 
volatile part and a permanent part on disk. 
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MONITORING 


INTRODUCTION 


To assist the network manager in achieving and maintaining 
good network performance, system managers of network nodes should 
closely monitor the network related aspects of their specific 
nodes. 

There are several software tools to monitor the network, such 

as: 

o Event Logging 
o NCP 
O MONITOR 

o NMCC/DECnet Monitor 
o VAX Ethernim 

OBJECTIVES 

At the end of this module the student will understand 

o The use of the event logger 

o The use of NCP to display counters 

o The way the MONITOR command can be used for DECnet 
o The function of NMCC/DECnet Monitor 
o The function of VAX Ethernim 

RESOURCES 


VAX/VMS Networking Manual 

VAX/VMS Network Control Program Reference Manual 
VAX/VMS Monitor Utility Reference Manual 
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MONITORING 

To assist the network manager in achieving and maintaining 
qood network performance, system managers of network nodes should 
closely monitor the network related aspects of their specific 
nodes. 

There are several software tools to monitor the network, such 

as: 

o Event Logging 
o NCP 
O MONITOR 

o NMCC/DECnet Monitor 
o VAX Ethernim 
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EVENT LOGGING 


DECnet software logs significant events that occur during 
network operation. An EVENT is a network on system-specific 
occurrence for which the logging component maintains a record. 
Significant events include: 


o Circuit, line and node counter activity 
o Changes in circuit, line and node states 
o Lost event reporting 

o Service requests 

o Routing performance and error counters 

o Data transmission performance and error counters 


This information is useful for monitoring the network because 
it can be recorded continuously by the event logger (EVL). 

You can control several aspects of event logging including: 


o Source-related parameters 

The actual events to be logged 

The source component for which events are collected 
The location where the events are logged 

o Sink-related parameters 

- The name of the logging component at the local node 

- The operational state of the logging component at the 
local node 
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Events are defined by class and type (Table 12-1). For the 
most part, events are logged for the various DNA layers and for 
system-specific resources. 

To display the logging status we use NCP: 

NCP> SHOW KNOWN LOGGING 

The result is shown in example 12—1. 


NCP> SHOW KNOWN LOGGING 

Known Logging Volatile Summary as of 17-AUG-1987 11:24:10 


Logging sink type - monitor 


Sink Node 

Source 

Events 

State Name 

4.23 (VAXA) 

(All sources) 

0.0-9 

on 

(All sources) 

2.0-1 



(All sources) 

4.2-13 15-16 
18-19 



(All sources) 

5.0-18 



(All sources) 

128.0-4 



Example 12-1: The use of NCP to show the logging status 
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Table 12-1: 

Event Logging Classes 

Class 

Description 

0 

Network Management Layer 

1 

Applications Layer 

2 

Session Control Layer 

3 

End Communication layer 

4 

Routing Layer 

5 

Data Link Layer 

6 

Physical Link Layer 

7-31 

Reserved for Other Common Classes 

32 - 63 

RSTS System-Specific 

64 - 95 

RSX System-Specific 

96 - 127 

TOPS-20 System-Specific 

128 - 159 

VMS System-Specific 

160 - 479 

Reserved for Future Use 
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Sink-Related Parameters 


Specifying the Logging Component 


The logging component is the device or process that records 
the events released by the event logger (see Figure 12-1). 


There are three types of logging components: 


o Logging Console 

o Logging File 


o Logging Monitor 

If no sink name is specified, defaults to Operator Communica¬ 
tion (OPCOM) facility.1 (VAX/VMS SPECIFIC). 


Displays formatted event messages on 
NETWORK (using REPLY/ENABLE-NET), 

(OPAO:)I(VAX/VMS SPECIFIC). 


all terminals enabled as 
including the console 
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Specifying the Operational State 


You can control the operational state of 
local node only. There are three logging states: 


logging for the 


o HOLD 


Indicates that the sink is temporarily unavailable 
Events destined for that location are queued 

o OFF 


Indicates that the sink is unavailable for receiving 
event information 

Events will not be logged for that sink 

o ON 

Indicates that the sink is available for receiving 
event information 

This is the normal operational state 
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DECnet Event 4.7, Circuit down, circuit fault 

From node 104 (BOSTON), Occurred 12-OCT-1986 12:37:14:24 

Circuit UNA-0 

line synchronization lost 

DECnet Event 4.7, Circuit down, circuit fault 
On node 8 (NASHUA), Occurred "28-SEPT-1986 19: 57:09:31 
Circuit DMC-0 

Adjacent node listener receive timeout 


Example 12-2: Event Logging Notices 
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NCP 


We can use NCP as a monitor. Generally we can use it to moni¬ 
tor one of the four components: 

o node 
o line 
o circuit 
o object 

NCP can display the following types: 


o counters 
o characteristics 
o status 
o summary 
o events 


The COUNTER information provides us statistical information 
for nodes, lines and circuits. 

The CHARACTERISTIC information includes the static informa¬ 
tion from the configuration database plus the parameters speci¬ 
fied by the network manager. 

The STATUS information includes dynamic information that 
usually reflects network operations for the running network. 

The SUMMARY information includes only the most useful in¬ 
formation from both static and dynamic sources. 
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The EVENTS information includes information about events cur- 
LOGGING. 


For effective monitoring 
information to a logging file: 


it is useful to write monitoring 


NCP> SHOW ACTIVE CIRCUIT SUMMARY TO SYS$MANAGER:NET.LIS 
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NCP> SHOW LINE UNA-0 COUNTERS 


- UNA-0 


26853 

Seconds since last zeroed 

38939 

Data blocks received 

11323 

Multicast blocks received 

0 

Receive failure 

2927668 

Bytes received 

1408038 

Multicast bytes received 

0 

Data overrun 

0 

Local buffer errors 

33104 

Data blocks sent 

2414 

Multicast blocks sent 

0 

Blocks sent, multiple collision 

0 

Blocks sent, single collision 

61 

Blocks sent, initially deferred 

2092951 

Bytes sent 

250074 

Multicast bytes sent 

0 

Send failure 

0 

Collision detect check failure 

20 

Unrecognized frame destination 

0 

System buffer unavailable 

0 

User buffer unavailable 


Example 12—3: The use of NCP to display the line counters 


NCP> SHOW CIRCUIT UNA-0 COUNTERS 
Circuit - UNA-0 


26485 

11353 

11636 

0 

0 

0 

0 

0 

0 

13561 

1164399 

22560 

2491338 

0 

0 


Seconds since last zeroed 
Terminating packets received 
Originating packets sent 
Terminating congestion loss 
Transit packets received 
Transit packets sent 
Transit congestion loss 
Circuit down 
Initialization failure 
Data blocks sent 
Bytes sent 

Data blocks received 
Bytes received 

Unrecognized frame destination 
User buffer unavailable 


Example 12 4: The use of NCP to display the circuit counters 
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NCP> SHO EXECUTOR COUNTERS 

Node Counters as of 17-AUG-1987 15:23:53 


Executor node • 4.23 (VAXA) 


25416 

173446 

174861 

3868 

3887 

16 

19 

8 

0 

6 

0 

0 

0 

0 

0 

0 

0 


Seconds since last zeroed 
Bytes received 
Bytes sent 
Messages received 
Messages sent 
Connects received 
Connects sent 
Response timeouts 

Received connect resource errors 
Maximum logical links active 
Aged packet loss 
Node unreachable packet loss 
Node out-of-range packet loss 
Oversized packet loss 
Packet format error 
Partial routing update loss 
Verification reject 


Example 12-5: The use of NCP to display the executor counters 


NCP> SHO NODE VAX COUNTERS 

Node Counters as of 17-AUG-1987 15:43:48 

Remote node - 4.13 (VAX) 


18255 Seconds since last zeroed 
69152 Bytes received 
522 Bytes sent 
150 Messages received 
142 Messages sent 
0 Connects received 
5 Connects sent 
2 Response timeouts 

0 Received connect resource errors 


Example 12-6: 


The use of NCP to display node counters 


12-12 



MONITORING 


MONITOR 


We can use the MONITOR utility to display the actual use of 
buffers by DECnet. 


$ MONITOR DECNET 


VAX/VMS Monitor Utility 
DECNET STATISTICS 
on node NOOT 



17 

-AUG-1987 11 

:46:57 





CUR 

AVE 

MIN 

MAX 

Arriving Local Packet 

Rate 

0.00 

1.10 

0.00 

1.66 

Departng Local Packet 

Rate 

0.00 

1.10 

0.00 

1.66 

Arriving Trans Packet 

Rate 

0.00 

0.00 

0.00 

0.00 

Trans Congestion Loss 

Rate 

0.00 

0.00 

0.00 

0.00 

Receiver Buff Failure 

Rate 

0.00 

0.00 

0.00 

0.00 

LRPs Available 


48.00 

48.66 

48.00 

49.00 


Example 12-7: The use of the VAX Monitor Utility 
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NHCC/DECNET MONITOR 


The Network Management Control Center/DECnet Monitor is a set 
of sophisticated tools for the observation and control of complex 
networks.toucan command the tools to present color graphics 
riienlavs that show the condition of the network. The tools also 
«?S 5*th 2 database of conjuration information.and network 
parameters; you can access and analyze the information and tune 
the network/ The NMCC/DECnet Monitor is a layered product that 
runs on most VAX/VMS systems. 

VAX ETHERNIM (ETHERNET NETWORK INTEGRITY MONITOR) 


VAX ETHERnim is a network maintenance application P*°9 ra 
Ethernet. It tests the communications path to nodes on the Ether- 
net. It also maintains a database containing information about 

each node. 
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SUMMARY 


To monitor the network we can use the EVENT LOGGER. Then the 
events can be logged in a file, at a console or in a file to use 
as input for a monitor utility. 

The -events in the network are identified by an event type 
numbe r. 

The second way to monitor is by using NCP. The NCP SHOW 
command for the volatile database, and the NCP LIST for the 
permanent database. 

Another way to monitor the network use is by the MONITOR 
utility. 
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APPENDIX A: NCP 


NCP 


The network Control Program (NCP) is a DECnet-VAX utility 
that accepts terminal commands to configure, control, monitor, 
and test a DECnet network. 


INVOKING AND EXITING THE NCP-UTILITY 

To invoke NCP, issue the DCL command. 

$RUN SYS$SYSTEM:NCP 

NCP will return the following prompt: 

NCP> 

Once you receive this prompt, you can issue NCP commands. To 
exit NCP, type EXIT or press CTRL/Z After the NCP> prompt. 

Alternatively, you can execute a single NCP command by using 
a DCL string assignment statement. For example: 

$ NCP:— $NCP 

$ NCP SHOW STATUS KNOWN LINES 
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Directing Output 

Output for the SHOW and LIST commands is normally displayed 
on the default output device, SYS$OUTPUT. Alternatively, you may 
direct output to a specified file using the TO qualifier with the 
SHOW or LIST command. 


Privileges/Restrictions 

Certain privileges are required to perform most NCP commands. 
The only commands that can be performed without privileges are 
CLEAR EXECUTOR NODE, HELP, LOOP EXECUTOR, LOOP LINE, LOOP NODE, 
SET EXECUTOR NODE, SHOW, and TELL. 

The PURGE, DEFINE, LIST and SET xxx ALL commands require the 
system privilege (SYSPRV) or some other way to access files with 
system protection, and the remaining NCP commands require the 
operator privilege (OPER). Note that at any time you may use 
access control parameters with the SET EXECUTOR NODE command to 
activate the network management listener (NML) to run under an 
account with the OPER privilege. 

You must have the DETACH, CMKRNL, SYSNAM, and SYSPRV privi¬ 
leges to start the network when it is not currently active. 
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Couands 


Syntax 

NCP> command component-name parameter [...][qualifier ][... ] 


NCP commands 

CLEAR/PURGE CIRCUIT 

CLEAR/PURGE EXECUTOR 

CLEAR EXECUTOR NODE 

CLEAR/PURGE LINE 

CLEAR/PURGE LOGGING 

CLEAR/PURGE LOGGING EVENTS 

CLEAR/PURGE LOGGING NAME 

CLEAR/PURGE MODULE X25-ACCESS 

CLEAR/PURGE MODULE X25-PROTOCOL 

CLEAR/PURGE MODULE X25-SERVER/X29-SERVER 

CLEAR/PURGE NODE 

CLEAR/PURGE NODE CIRCUIT 

CLEAR/PURGE OBJECT 

CONNECT NODE 

CONNECT VIA 

COPY KNOWN NODES 

DISCONNECT LINK 

HELP 

LOAD NODE 
LOAD VIA 
LOOP CIRCUIT 
LOOP EXECUTOR 
LOOP LINE 
LOOP NODE 

PURGE MODULE CONFIGURATOR 

SET CIRCUIT ALL 

SET/DEFINE CIRCUIT 

SET/EXECUTOR ALL 

SET/DEFINE EXECUTOR 

SET EXECUTOR NODE 

SET LINE ALL 

SET/DEFINE LINE 

SET LOGGING ALL 

SET/DEFINE LOGGING EVENTS 

SET/DEFINE LOGGING STATE 

SET/DEFINE MODULE CONFIGURATOR 

SET/DEFINE MODULE X25-ACCESS 

SET/DEFINE MODULE X25-PROTOCOL 

SET/DEFINE MODULE X25-SERVER/X29-SERVER 

SET NODE ALL 
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SET/DEFINE NODE 

SET/DEFINE NODE CIRCUIT 

SET OBJECT ALL 

SET/DEFINE OBJECT 

SHOW AREA 

SHOW/LIST CIRCUIT 

SHOW/LIST EXECUTOR 

SHOW/LIST LINE 

SHOW LINKS 

SHOW/LIST LOGGING 

SHOW/LIST MODULE CONFIGURATOR 

SHOW/LIST MODULE X25-ACCESS 

SHOW/LIST MODULE X25-PROTOCOL 

SHOW/LIST MODULE X25-SERVER/X29-SERVER 

SHOW/LIST NODE 

SHOW/LIST OBJECT 

TELL 

TRIGGER NODE 
TRIGGER VIA 
ZERO CIRCUITS 
ZERO EXECUTOR 
ZERO LINE 

ZERO MODULE X25-PROTOCOL 

ZERO MODULE X25-SERVER/X29-SERVER 

ZERO NODE 
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